@happyvertical/smrt-core 0.38.18 → 0.38.20

package/AGENTS.md

@@ -11,6 +11,7 @@ ORM, code generation, AI integration, and the DispatchBus. Everything else build
 | ObjectRegistry | `src/registry.ts` | Global singleton (globalThis) — class metadata, fields, STI chains, manifests |
 | DispatchBus | `src/dispatch/bus.ts` | Inter-agent messaging — emit, subscribe (persistent), process |
 | GlobalInterceptors | `src/interceptors.ts` | Plugin system — beforeList/Get/Save/Delete hooks (used by tenancy) |
+| LearningMemory | `src/learning/memory.ts` | Confidence-scored recall/capture over `_smrt_contexts` + embeddings (#1886) |
 
 ## SmrtObject Lifecycle
 
@@ -22,6 +23,25 @@ ORM, code generation, AI integration, and the DispatchBus. Everything else build
 - `getSlug()`: auto-generates from name → title → label → id
 - `loadRelated(fieldName)`: lazy-loads relationships (cached in `_loadedRelationships` Map)
 
+## LearningMemory (#1886)
+
+Confidence-scored, self-correcting memory over the existing `_smrt_contexts` (keyed recall) and `_smrt_embeddings` (semantic recall) substrate. Wires the reinforcement columns that ship on `_smrt_contexts` but were never written (`success_count`, `failure_count`, and a `last_used_at` that recall now refreshes). This is L1 of the tenant-learning-agents epic; the opt-in `Learning` trait in `@happyvertical/smrt-agents` composes it into the agent lifecycle.
+
+```typescript
+const memory = new LearningMemory({ db: obj.systemDb, ownerClass: 'InvoiceAgent', ownerId: obj.id, tenantId });
+
+// recall — union of keyed-context lookup + (optional) semantic search, confidence-filtered
+const [hit] = await memory.recall('parser/acme', { key: docUrl }); // or { query } with a wired semanticSearch
+const strategy = hit?.value ?? (await generate());
+
+// capture — reinforce the outcome
+await memory.capture({ scope: 'parser/acme', key: docUrl, value: strategy }, { success: ok });
+```
+
+- **`capture(episode, outcome)`**: success strengthens `confidence` toward 1.0 + increments `success_count`; failure decays toward `failureConfidence` (default 0.3) + increments `failure_count`. Defaults (`minConfidence` 0.7, `successConfidence` 0.9, `reinforcement` 0.5) mean a single failure drops a confident memory below the reuse floor. Seeds a new row when none exists and the episode carries a `value` (a failed first attempt is retained at low confidence for self-correction).
+- **`recall(scope, opts)`**: owner-scoped keyed lookup (thus tenant-isolated) filtered by the confidence floor, expiry, and optional time-decay, with hierarchical scope fallback; unions an injected `semanticSearch` arm when a `query` is given (tenant-scoped via its `where`). Refreshes `last_used_at` on returned rows.
+- Injected `semanticSearch` matches `SmrtCollection.semanticSearch`, so `LearningMemory` never reaches into a collection's internals.
+
 ## SmrtCollection Query
 
 ```typescript
@@ -31,6 +51,14 @@ await collection.list({
 });
 ```
 
+Projection primitive (#1902): pass `select: ['id', 'title', 'tenantId']` to
+`list()` when an admin/list workflow needs compact rows. `select` uses SMRT
+field names, maps them to DB columns internally, and returns plain objects keyed
+by the same SMRT field names without hydrating `SmrtObject` instances. It
+composes with `where`, `orderBy`, `limit`, and `offset`; `beforeList`
+interceptors still run. It is for column-backed fields only and cannot combine
+with `include`/relationship eager loading.
+
 **WHERE operators**: `=`, `>`, `<`, `>=`, `<=`, `!=`, `in`, `not in`, `like`, `is null`, `is not null`. Arrays auto-detect `IN`. Dot notation for JSON paths: `metadata.userId`.
 
 STI child collections auto-filter by `_meta_type`.

package/dist/collection.d.ts

@@ -51,20 +51,72 @@ export type SmrtCreateInput<T extends SmrtObject> = Partial<Omit<{
  * `convertWhereKeys()` handles field and operator checking.
  */
 export type SmrtWhereClause<T extends SmrtObject> = Record<string, unknown>;
+type SmrtModelData<T extends SmrtObject> = Omit<{
+    [K in keyof T as T[K] extends (...args: never[]) => unknown ? never : K]: T[K];
+}, SmrtInternalKeys>;
+/**
+ * Logical field names accepted by `collection.list({ select })`.
+ *
+ * `select` is intentionally a column-backed projection primitive: callers pass
+ * SMRT field names such as `parentId`, and the collection maps them to database
+ * columns such as `parent_id` while returning rows keyed by the original SMRT
+ * field names.
+ */
+export type SmrtSelectField<T extends SmrtObject> = Extract<keyof SmrtModelData<T>, string> | 'id' | 'slug' | 'context' | 'created_at' | 'updated_at' | '_meta_type';
+type SmrtCoreSelectedFieldData = {
+    id: string | null | undefined;
+    slug: string | null | undefined;
+    context: string;
+    created_at: Date | null | undefined;
+    updated_at: Date | null | undefined;
+    _meta_type: string;
+};
+/**
+ * Plain row shape returned by `collection.list({ select })`.
+ */
+export type SmrtSelectedRow<T extends SmrtObject, Select extends readonly SmrtSelectField<T>[]> = {
+    [Field in Select[number]]: Field extends keyof SmrtCoreSelectedFieldData ? SmrtCoreSelectedFieldData[Field] : Field extends keyof SmrtModelData<T> ? SmrtModelData<T>[Field] : unknown;
+};
+export interface SmrtListOptions<ModelType extends SmrtObject> {
+    where?: SmrtWhereClause<ModelType>;
+    offset?: number;
+    limit?: number;
+    orderBy?: string | string[];
+    /**
+     * Column-backed field projection. When present, `list()` returns plain rows
+     * instead of hydrated model instances.
+     */
+    select?: readonly SmrtSelectField<ModelType>[];
+    /**
+     * Relationships to eagerly load. Only supported for hydrated list() calls.
+     */
+    include?: string[];
+    /**
+     * Opt-in read-through cache for this call (issue #1498).
+     */
+    cache?: CollectionCacheConfig | false;
+}
 /**
  * Minimal runtime shape of a field definition as consumed by the collection's
  * query/hydration helpers (`getFieldsSync()`, `convertWhereKeys()`,
  * `formatDataJs()`). These come from `fieldsFromClass()` /
  * `ObjectRegistry.getFields()` and only a few members are read here: `type`
- * (for `formatDataJs` value coercion) and the `sensitive` markers (for the
- * `@field({ sensitive: true })` WHERE guard, #1540). The index signature keeps
- * the bag open for the other registry-attached members without forcing `any`.
+ * (for `formatDataJs` value coercion) and the field-level access markers. The
+ * index signature keeps the bag open for the other registry-attached members
+ * without forcing `any`.
  */
 interface CollectionFieldDefinition {
     type?: string;
+    primaryKey?: boolean;
+    transient?: boolean;
     sensitive?: boolean;
+    readPermission?: string;
     _meta?: {
         sensitive?: boolean;
+        readPermission?: string;
+        transient?: boolean;
+        primaryKey?: boolean;
+        __smrtSystemField?: boolean;
     } & Record<string, unknown>;
     [key: string]: unknown;
 }
@@ -139,6 +191,16 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * ```
      */
     private convertWhereKeys;
+    private toDbColumnName;
+    private assertSafeProjectionFieldName;
+    private quoteProjectionIdentifier;
+    private isSensitiveFieldDefinition;
+    private getReadPermissionFieldDefinition;
+    private collectSensitiveFieldNames;
+    private hasCustomPrimaryKey;
+    private isOmittedCustomPrimaryKeySystemField;
+    private resolveProjectionSelect;
+    private formatProjectionRow;
     /**
      * Gets the class constructor for items in this collection
      */
@@ -299,7 +361,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * The cache key is the final SQL + bound parameters — computed after
      * interceptors (tenancy filters) and STI discriminators are applied, so
      * differently-scoped queries can never share an entry. Cached values are
-     * raw rows; hydration and read interceptors still run on every call.
+     * raw rows; callers still run their normal post-query formatting path.
      */
     private queryRowsWithCache;
     /**
@@ -351,6 +413,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * @param options.offset - Number of records to skip
      * @param options.limit - Maximum number of records to return
      * @param options.orderBy - Field(s) to order results by, with optional direction
+     * @param options.select - Column-backed fields to return as plain rows without hydrating model instances
      *
      * @example
      * ```typescript
@@ -377,46 +440,24 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      *     'last_login <': lastMonth
      *   }
      * });
+     *
+     * // Fetch compact page-key rows without constructing full objects
+     * await collection.list({
+     *   select: ['id', 'title', 'accountId'],
+     *   where: { status: 'open' },
+     *   orderBy: 'created_at DESC',
+     *   limit: 50,
+     * });
      * ```
      *
-     * @returns Promise resolving to an array of model instances
+     * @returns Promise resolving to an array of model instances, or plain selected rows when `select` is present
      */
-    list(options?: {
-        where?: SmrtWhereClause<ModelType>;
-        offset?: number;
-        limit?: number;
-        orderBy?: string | string[];
-        /**
-         * Relationships to eagerly load (avoids N+1 query problem)
-         * @example
-         * ```typescript
-         * // Load orders with their customers pre-loaded
-         * const orders = await orderCollection.list({
-         *   include: ['customerId']
-         * });
-         * // Access customer without additional query
-         * orders[0].getRelated('customerId');
-         * ```
-         */
-        include?: string[];
-        /**
-         * Opt-in read-through cache for this call (issue #1498).
-         *
-         * Pass `{ ttl }` (milliseconds) to memoize the result rows keyed by
-         * the final query shape. Mutations through SMRT invalidate the
-         * table's entries automatically. Pass `false` to force a fresh read
-         * when the model opted in via `@smrt({ cache })`. Defaults to the
-         * model-level config; uncached when neither is set.
-         *
-         * @example
-         * ```typescript
-         * const published = await resumes.list({
-         *   where: { status: 'published' },
-         *   cache: { ttl: 60_000 },
-         * });
-         * ```
-         */
-        cache?: CollectionCacheConfig | false;
+    list<const Select extends readonly SmrtSelectField<ModelType>[]>(options: SmrtListOptions<ModelType> & {
+        select: Select;
+        include?: never;
+    }): Promise<SmrtSelectedRow<ModelType, Select>[]>;
+    list(options?: Omit<SmrtListOptions<ModelType>, 'select'> & {
+        select?: undefined;
     }): Promise<ModelType[]>;
     /**
      * Eagerly load relationships for a collection of instances

package/dist/collection.d.ts.map

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

package/dist/collection.js

@@ -116,18 +116,7 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 		];
 		const fields = this.getFieldsSync();
 		const validFieldNames = new Set(Object.keys(fields).map((f) => toSnakeCase(f)));
-		const sensitiveFieldNames = /* @__PURE__ */ new Set();
-		const collectSensitive = (fieldMap) => {
-			const entries = fieldMap instanceof Map ? fieldMap.entries() : Object.entries(fieldMap);
-			for (const [fieldName, rawDef] of entries) {
-				const def = rawDef;
-				if (def && (def.sensitive === true || def._meta?.sensitive === true)) {
-					sensitiveFieldNames.add(toSnakeCase(fieldName));
-					sensitiveFieldNames.add(fieldName);
-				}
-			}
-		};
-		collectSensitive(fields);
+		const sensitiveFieldNames = this.collectSensitiveFieldNames(fields);
 		validFieldNames.add("id");
 		validFieldNames.add("slug");
 		validFieldNames.add("context");
@@ -145,10 +134,10 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 				if (ancestorName === "SmrtObject" || ancestorName === "SmrtClass" || ancestorName === itemQualifiedName || ancestorName === itemClassName) continue;
 				const ancestorFields = ObjectRegistry.getFields(ancestorName);
 				for (const fieldName of ancestorFields.keys()) validFieldNames.add(toSnakeCase(fieldName));
-				collectSensitive(ancestorFields);
+				this.collectSensitiveFieldNames(ancestorFields, sensitiveFieldNames);
 			}
 			const stiBase = ObjectRegistry.getSTIBase(itemQualifiedName);
-			if (stiBase) for (const descendant of ObjectRegistry.getDescendants(stiBase)) collectSensitive(ObjectRegistry.getFields(descendant));
+			if (stiBase) for (const descendant of ObjectRegistry.getDescendants(stiBase)) this.collectSensitiveFieldNames(ObjectRegistry.getFields(descendant), sensitiveFieldNames);
 		}
 		const skipFieldValidation = !(Object.keys(fields).length > 0);
 		const converted = {};
@@ -177,6 +166,88 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 		}
 		return converted;
 	}
+	toDbColumnName(fieldName) {
+		return fieldName.startsWith("_") ? `_${toSnakeCase(fieldName.slice(1))}` : toSnakeCase(fieldName);
+	}
+	assertSafeProjectionFieldName(fieldName) {
+		if (fieldName === "__proto__" || fieldName === "constructor" || fieldName === "prototype") throw new Error(`Invalid select field: '${fieldName}'. Prototype pollution attempts are not allowed.`);
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(fieldName)) throw new Error(`Invalid select field: '${fieldName}'. Field names must be identifiers (letters, digits, underscore).`);
+	}
+	quoteProjectionIdentifier(identifier) {
+		this.assertSafeProjectionFieldName(identifier);
+		return `"${identifier.replace(/"/g, "\"\"")}"`;
+	}
+	isSensitiveFieldDefinition(fieldDef) {
+		return fieldDef?.sensitive === true || fieldDef?._meta?.sensitive === true;
+	}
+	getReadPermissionFieldDefinition(fieldDef) {
+		if (typeof fieldDef?.readPermission === "string") return fieldDef.readPermission;
+		if (typeof fieldDef?._meta?.readPermission === "string") return fieldDef._meta.readPermission;
+	}
+	collectSensitiveFieldNames(fieldMap, target = /* @__PURE__ */ new Set()) {
+		const entries = fieldMap instanceof Map ? fieldMap.entries() : Object.entries(fieldMap);
+		for (const [fieldName, fieldDef] of entries) if (this.isSensitiveFieldDefinition(fieldDef)) {
+			target.add(toSnakeCase(fieldName));
+			target.add(fieldName);
+		}
+		return target;
+	}
+	hasCustomPrimaryKey(fields) {
+		return Object.values(fields).some((fieldDef) => fieldDef.primaryKey === true || fieldDef._meta?.primaryKey === true);
+	}
+	isOmittedCustomPrimaryKeySystemField(fieldName, hasCustomPrimaryKey, explicitFieldNames) {
+		return hasCustomPrimaryKey && !explicitFieldNames.has(fieldName) && (fieldName === "id" || fieldName === "slug" || fieldName === "context");
+	}
+	resolveProjectionSelect(select, fields, isSTI) {
+		if (!Array.isArray(select)) throw new Error("Invalid select option: expected an array of field names.");
+		if (select.length === 0) throw new Error("Invalid select option: at least one field name is required.");
+		const customPrimaryKey = this.hasCustomPrimaryKey(fields);
+		const itemClassName = this.getResolvedItemClassName();
+		const itemQualifiedName = this.getResolvedItemQualifiedName();
+		const schema = ObjectRegistry.getSchema(itemQualifiedName) ?? ObjectRegistry.getSchema(itemClassName);
+		const schemaColumnNames = schema?.columns ? new Set(Object.keys(schema.columns)) : void 0;
+		const registeredFields = ObjectRegistry.getFields(itemQualifiedName);
+		const explicitFields = registeredFields.size > 0 ? registeredFields : ObjectRegistry.getFields(itemClassName);
+		const explicitFieldNames = new Set(explicitFields.keys());
+		const validFieldNames = /* @__PURE__ */ new Set();
+		for (const [fieldName, fieldDef] of Object.entries(fields)) {
+			if (this.isOmittedCustomPrimaryKeySystemField(fieldName, customPrimaryKey, explicitFieldNames)) continue;
+			const columnName = this.toDbColumnName(fieldName);
+			if (schemaColumnNames && !schemaColumnNames.has(columnName)) continue;
+			validFieldNames.add(fieldName);
+		}
+		if (isSTI && (!schemaColumnNames || schemaColumnNames.has("_meta_type"))) validFieldNames.add("_meta_type");
+		const seen = /* @__PURE__ */ new Set();
+		const outputFields = [];
+		const selectExpressions = [];
+		for (const fieldName of select) {
+			if (typeof fieldName !== "string") throw new Error(`Invalid select field: expected a string field name, got ${typeof fieldName}.`);
+			this.assertSafeProjectionFieldName(fieldName);
+			if (seen.has(fieldName)) throw new Error(`Invalid select field: '${fieldName}' was requested more than once.`);
+			seen.add(fieldName);
+			if (!validFieldNames.has(fieldName)) throw new Error(`Invalid select field: '${fieldName}'. Field does not exist on ${itemClassName}. Valid fields: ${Array.from(validFieldNames).sort().join(", ")}`);
+			const fieldDef = fields[fieldName];
+			const fieldType = fieldDef?.type;
+			if (this.isSensitiveFieldDefinition(fieldDef)) throw new Error(`Invalid select field: '${fieldName}' is sensitive and cannot be projected by collection.list({ select }).`);
+			const readPermission = this.getReadPermissionFieldDefinition(fieldDef);
+			if (readPermission) throw new Error(`Invalid select field: '${fieldName}' is gated by readPermission '${readPermission}' and cannot be projected by collection.list({ select }).`);
+			const isTransient = fieldDef?.transient === true || fieldDef?._meta?.transient === true;
+			if (fieldType === "meta" || isTransient || fieldType === "oneToMany" || fieldType === "manyToMany") throw new Error(`Invalid select field: '${fieldName}' is not a column-backed field on ${itemClassName}.`);
+			const columnName = this.toDbColumnName(fieldName);
+			selectExpressions.push(`${this.quoteProjectionIdentifier(columnName)} AS ${this.quoteProjectionIdentifier(fieldName)}`);
+			outputFields.push(fieldName);
+		}
+		return {
+			sql: selectExpressions.join(", "),
+			outputFields
+		};
+	}
+	formatProjectionRow(row, fields, outputFields) {
+		const formattedData = this.withHydratedCoreFields(formatDataJs(row, fields));
+		const projected = {};
+		for (const fieldName of outputFields) projected[fieldName] = formattedData[fieldName];
+		return projected;
+	}
 	/**
 	* Gets the class constructor for items in this collection
 	*/
@@ -412,7 +483,7 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 	* The cache key is the final SQL + bound parameters — computed after
 	* interceptors (tenancy filters) and STI discriminators are applied, so
 	* differently-scoped queries can never share an entry. Cached values are
-	* raw rows; hydration and read interceptors still run on every call.
+	* raw rows; callers still run their normal post-query formatting path.
 	*/
 	async queryRowsWithCache(sql, params, cacheConfig) {
 		if (!cacheConfig) return (await this.db.query(sql, ...params)).rows;
@@ -492,52 +563,13 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 		const instance = await this.hydrateResultRow(rows[0], fields, isSTI);
 		return await GlobalInterceptors.executeAfterGet(itemClassName, instance, interceptorContext);
 	}
-	/**
-	* Lists records from the collection with flexible filtering options
-	*
-	* @param options - Query options object
-	* @param options.where - Record of conditions to filter results. Each key can include an operator
-	*                      separated by a space (e.g., 'price >', 'name like'). Default operator is '='.
-	* @param options.offset - Number of records to skip
-	* @param options.limit - Maximum number of records to return
-	* @param options.orderBy - Field(s) to order results by, with optional direction
-	*
-	* @example
-	* ```typescript
-	* // Find active products priced between $100-$200
-	* await collection.list({
-	*   where: {
-	*     'price >': 100,
-	*     'price <=': 200,
-	*     'status': 'active',              // equals operator is default
-	*     'category in': ['A', 'B', 'C'],  // IN operator for arrays
-	*     'name like': '%shirt%',          // LIKE for pattern matching
-	*     'deleted_at !=': null            // exclude deleted items
-	*   },
-	*   limit: 10,
-	*   offset: 0
-	* });
-	*
-	* // Find users matching pattern but not in specific roles
-	* await users.list({
-	*   where: {
-	*     'email like': '%@company.com',
-	*     'active': true,
-	*     'role in': ['guest', 'blocked'],
-	*     'last_login <': lastMonth
-	*   }
-	* });
-	* ```
-	*
-	* @returns Promise resolving to an array of model instances
-	*/
 	async list(options = {}) {
 		await this.ensureStorageReady();
 		const itemClassName = this.getResolvedItemClassName();
 		const itemQualifiedName = this.getResolvedItemQualifiedName();
 		const interceptorContext = createInterceptorContext(itemClassName, "list", this.constructor.name);
 		const interceptedOptions = await GlobalInterceptors.executeBeforeList(itemClassName, options, interceptorContext) ?? options ?? {};
-		let { where, offset, limit, orderBy } = interceptedOptions;
+		let { where, offset, limit, orderBy, select } = interceptedOptions;
 		const isSTI = ObjectRegistry.getTableStrategy(itemQualifiedName) === "sti";
 		if (isSTI) {
 			const stiBase = ObjectRegistry.getSTIBase(itemQualifiedName);
@@ -548,6 +580,9 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 		}
 		where = resolveMetaTypeInWhere(where);
 		const { sql: whereSql, values: whereValues } = buildWhere(this.convertWhereKeys(where || {}));
+		const fields = this.getFieldsSync();
+		const projection = select !== void 0 ? this.resolveProjectionSelect(select, fields, isSTI) : void 0;
+		if (projection && interceptedOptions.include && interceptedOptions.include.length > 0) throw new Error("collection.list({ select }) returns plain projection rows and cannot eager-load relationships. Remove include or omit select.");
 		let orderBySql = "";
 		if (orderBy) {
 			orderBySql = " ORDER BY ";
@@ -570,10 +605,10 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 			limitOffsetSql += ` OFFSET $${paramIndex++}`;
 			limitOffsetValues.push(offset);
 		}
-		const sql = `SELECT * FROM ${this.tableName} ${whereSql} ${orderBySql} ${limitOffsetSql}`;
+		const sql = `SELECT ${projection ? projection.sql : "*"} FROM ${this.tableName} ${whereSql} ${orderBySql} ${limitOffsetSql}`;
 		const params = [...whereValues, ...limitOffsetValues];
 		const rows = await this.queryRowsWithCache(sql, params, this.resolveReadCacheConfig(interceptedOptions.cache));
-		const fields = this.getFieldsSync();
+		if (projection) return rows.map((item) => this.formatProjectionRow(item, fields, projection.outputFields));
 		const instances = await Promise.all(rows.map((item) => this.hydrateResultRow(item, fields, isSTI)));
 		if (interceptedOptions.include && interceptedOptions.include.length > 0) await this.eagerLoadRelationships(instances, interceptedOptions.include);
 		return await GlobalInterceptors.executeAfterList(itemClassName, instances, interceptorContext);