@happyvertical/smrt-types 0.40.65 → 0.40.67

package/AGENTS.md

@@ -10,9 +10,11 @@ Shared TypeScript type definitions. Prevents circular dependencies between packa
 | `module.ts` | `SmrtModuleMeta`, `ModuleUISlot`, `ModuleComponentType` — module registration and UI slots |
 | `user.ts` | `UserStatus`, `TenantStatus`, `MembershipStatus`, `SessionStatus`, `OverrideEffect` — status enums |
 | `identity.ts` | `User`, `Tenant`, `Role`, `Membership`, `SmrtEntityFields` — cross-package identity data contracts (runtime classes live in smrt-users, which `implements` these) |
+| `knowledge.ts` | Additive schema-version-1 domain knowledge contracts shared by core generation and development tooling |
 
 ## Rules
 
 - **Zero runtime code**: only type definitions and enums
 - **Always `import type`**: use `import type { Signal }` to avoid runtime imports (except enums which have runtime values)
 - **Add shared types here**: if two+ packages need the same type, put it here instead of in `smrt-core`
+- **Knowledge compatibility**: keep `DomainKnowledgeManifest.schemaVersion` at 1 for additive optional facts and preserve `DomainKnowledgeObject.methods: string[]`; structured signatures live in the optional `methodSignatures` sibling. Generators set `sensitiveFieldsExcluded: true`; readers must treat its absence as a legacy artifact that needs raw-manifest corroboration.

package/dist/index.d.ts

@@ -163,6 +163,28 @@ export declare interface DomainKnowledgeConfig {
     risks?: string[];
 }
 
+/** A field retained in the curated agent-facing object shape. */
+export declare interface DomainKnowledgeField {
+    name: string;
+    type: string;
+    required?: boolean;
+    related?: string;
+    columnType?: string;
+    default?: unknown;
+    constraints?: DomainKnowledgeFieldConstraints;
+    readonly?: boolean;
+    transient?: boolean;
+}
+
+/** Validation constraints retained in the curated agent-facing field shape. */
+export declare interface DomainKnowledgeFieldConstraints {
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+
 /** Result of a domain-knowledge freshness check (stale references, error/warning counts). */
 export declare interface DomainKnowledgeFreshnessResult {
     ok: boolean;
@@ -183,6 +205,8 @@ export declare interface DomainKnowledgeFreshnessResult {
 /** The package-level domain-knowledge artifact (`smrt-knowledge.json`) — the agent/developer contract. */
 export declare interface DomainKnowledgeManifest {
     schemaVersion: 1;
+    /** True when generation removed sensitive fields before projecting objects. */
+    sensitiveFieldsExcluded?: true;
     generatedAt: string;
     packageName?: string;
     packageVersion?: string;
@@ -215,6 +239,15 @@ export declare interface DomainKnowledgeManifest {
     moduleDocs?: DomainKnowledgeModuleDoc[];
 }
 
+/** Additive structured signature; `methods: string[]` remains the compatibility surface. */
+export declare interface DomainKnowledgeMethodSignature {
+    name: string;
+    async?: boolean;
+    static?: boolean;
+    params?: string[];
+    returns?: string;
+}
+
 /**
  * A sibling module doc linked from a package's `AGENTS.md` (#2108).
  *
@@ -241,21 +274,13 @@ export declare interface DomainKnowledgeObject {
     packageName?: string;
     extends?: string;
     visibility?: string;
-    fields: Array<{
-        name: string;
-        type: string;
-        required?: boolean;
-        related?: string;
-        columnType?: string;
-    }>;
-    relationships: Array<{
-        name: string;
-        type: string;
-        required?: boolean;
-        related?: string;
-        columnType?: string;
-    }>;
+    fields: DomainKnowledgeField[];
+    relationships: DomainKnowledgeField[];
     methods: string[];
+    methodSignatures?: DomainKnowledgeMethodSignature[];
+    tenant?: DomainKnowledgeTenant;
+    tableStrategy?: 'cti' | 'sti';
+    conflictColumns?: string[];
     surfaces: DomainKnowledgeSurface[];
     relationshipFeatures: string[];
     tags: string[];
@@ -277,6 +302,13 @@ export declare interface DomainKnowledgeSurface {
 /** Kind of generated surface a knowledge entry describes (REST/CLI/MCP/AI). */
 export declare type DomainKnowledgeSurfaceKind = 'api' | 'cli' | 'mcp' | 'ai';
 
+/** Normalized tenancy facts from `@smrt({ tenantScoped })`. */
+export declare interface DomainKnowledgeTenant {
+    scoped: boolean;
+    mode?: 'required' | 'optional';
+    field?: string;
+}
+
 /** User↔Tenant↔Role junction. Runtime class: `@happyvertical/smrt-users:Membership`. */
 export declare interface Membership extends SmrtEntityFields {
     userId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-types",
-  "version": "0.40.65",
+  "version": "0.40.67",
   "description": "Shared type definitions for the HAVE SDK",
   "type": "module",
   "main": "./dist/index.js",