@uwmd/core 1.7.0 → 1.8.0

package/dist/types.d.ts

@@ -8,7 +8,12 @@ export type DealStage = 'scope' | 'screening' | 'term_sheet' | 'full_underwrite'
  * 'agent/L6-01', 'document/rent_roll'). Free-form strings remain valid for
  * forward compat; this union enumerates the canonical values.
  *
- * Cascade-resolved values use the lower seven tags below; see protocol §IX.
+ * **RFC 0031 split the field.** `_meta.source` is now actor-only
+ * (`manual | agent/<id> | document/<id> | system/<id> | institution/<id>`);
+ * the resolution-method tags below belong in `_meta.resolution`. A canonical
+ * tag found in `_meta.source` is interpreted at read time as `resolution`
+ * (with the actor treated as absent) and warns under `SRC-02`. See protocol
+ * §V.3/§V.7 and format spec §2.6.
  */
 export type SourceTag = 'user_input' | 'user_override' | 'manual'
 /**
@@ -26,7 +31,48 @@ export type SourceTag = 'user_input' | 'user_override' | 'manual'
  * recognize this tag MUST NOT rewrite it to `user_input`.
  */
  | 'market_data_accepted' | 'ai_extracted' | 'agent_computed' | 'asset_class_default' | 'scenario_default' | 'global_default' | 'system_default' | (string & {});
+/**
+ * The full set of canonical short-form source tags. As of RFC 0031 these are
+ * the **resolution-method** vocabulary — producers stamp them into
+ * `_meta.resolution` (a tag found in `_meta.source` is legacy and is
+ * interpreted as `resolution` at read time). Eight of these match
+ * `CascadeStep` 1:1; the rest are non-cascade tags — `manual`,
+ * `ai_extracted`, `agent_computed`, `scenario_default`, and
+ * `market_data_accepted`.
+ *
+ * `market_data_accepted` (RFC 0022 §4) is deliberately *not* a cascade step:
+ * it is an in-file value of record that resolves at the `user_input` step
+ * while keeping its own tag, because a value accepted for lack of better
+ * evidence must stay distinguishable from one someone typed in.
+ *
+ * `scenario_default` is retained but its meaning is sharpened to mean
+ * "value derived from a named scenario in the file or institution
+ * config." Producers needing a generic fallback SHOULD use
+ * `system_default` instead.
+ *
+ * Actor patterns (`manual`, `agent/L6-01`, `document/rent_roll`, …) are a
+ * separate vocabulary — see `ACTOR_NAMESPACES` / `parseActorSource` in
+ * `protocol.ts`.
+ */
+export declare const SOURCE_TAGS: readonly ["user_input", "user_override", "manual", "inherited_assumption", "investor_profile", "market_data", "market_data_accepted", "ai_extracted", "agent_computed", "asset_class_default", "scenario_default", "global_default", "system_default"];
+export type CanonicalSourceTag = (typeof SOURCE_TAGS)[number];
 export type AssetClass = 'multifamily' | 'office' | 'retail' | 'industrial' | 'self_storage' | 'hospitality' | 'mixed_use' | 'senior_housing' | 'student_housing' | 'land';
+/**
+ * An asset class as it may appear in a document: a builtin, or a
+ * module-declared custom identifier (RFC 0003, protocol §X.2).
+ *
+ * Deliberately separate from {@link AssetClass}, which stays a closed union.
+ * Folding custom ids into `AssetClass` would collapse it to `string` and take
+ * `ASSET_CLASS_MEMBERS`, every pack and layout lookup's narrowing, and the
+ * §XIII / §5.1 class tables down with it. Anything that needs a *builtin*
+ * still asks for `AssetClass`; this type is for the boundary — frontmatter and
+ * module declarations — where a custom class is legal.
+ *
+ * The `(string & {})` arm keeps editor autocomplete on the builtin members
+ * while accepting any identifier; `parseAssetClass` is what actually validates
+ * one.
+ */
+export type UWAssetClassId = AssetClass | (string & {});
 /**
  * Every v1 asset class, as a runtime list. Derived from {@link AssetClass} via
  * {@link ASSET_CLASS_MEMBERS}, so it is exactly the union — no more, no less.
@@ -40,7 +86,16 @@ export interface UWFieldOverride {
     /** Dot-notated path relative to the block's content root (e.g. "units[7].current_rent"). */
     path: string;
     confidence?: ConfidenceLevel;
+    /** Actor override for this field (RFC 0031 actor grammar; legacy tags are
+     *  read as `resolution` — see §2.6 read-time interpretation). */
     source?: SourceTag;
+    /**
+     * How this field's value was resolved (a canonical `SOURCE_TAGS` member,
+     * e.g. the cascade step that produced it — protocol §V.7 permits stamping
+     * at leaf level). A leaf-level `resolution` wins over the block-level one
+     * for its path. RFC 0031.
+     */
+    resolution?: SourceTag;
     reason?: 'illegible' | 'missing' | 'overridden' | 'estimated' | 'computed';
     note?: string;
 }
@@ -48,7 +103,20 @@ export interface UWMeta {
     section: string;
     version: number;
     superseded: boolean;
+    /**
+     * Who wrote the block — `manual` or `<namespace>/<id>` with a registered
+     * actor namespace (RFC 0031; grammar in format spec §2.6, authority in
+     * protocol §V.3). Legacy canonical tags in this field are interpreted as
+     * `resolution` at read time and warn under `SRC-02`.
+     */
     source: SourceTag;
+    /**
+     * How the block's value was resolved — one canonical `SOURCE_TAGS` member
+     * (`user_input`, `asset_class_default`, …). Optional and orthogonal to
+     * `source`: an agent that filled a field from the asset-class default table
+     * has both an actor and a method. RFC 0031; protocol §V.7.
+     */
+    resolution?: SourceTag;
     agent_id: string | null;
     agent_version: string | null;
     actor: string;
@@ -87,10 +155,20 @@ export interface UWMeta {
      * in that chain MUST.
      */
     parent_hash?: string | null;
+    /**
+     * Detached signature over this block's signing input (protocol §V.11,
+     * RFC 0010). Optional and opaque to core: the wire shape is normative here,
+     * but the cryptography lives in `@uwmd/signing` so that the library stays
+     * dependency-free for the overwhelming majority of adopters who never sign.
+     *
+     * Excluded from `content_hash` canonicalization along with `content_hash`
+     * itself, so stamping a signature does not invalidate the hash it covers.
+     */
+    signature?: UWBlockSignature;
     /**
      * Which observation set a `market_data_accepted` value was promoted from
-     * (RFC 0022 §4). REQUIRED whenever `source` is `market_data_accepted`, and
-     * meaningless otherwise.
+     * (RFC 0022 §4). REQUIRED whenever `resolution` (or, pre-split, `source`)
+     * is `market_data_accepted`, and meaningless otherwise.
      *
      * Without it, "accepted from market data" is an unfalsifiable claim: a
      * reviewer could see the tag but never recover *which* observations, of which
@@ -99,12 +177,42 @@ export interface UWMeta {
     market_data_ref?: MarketDataRef;
     /**
      * Which ancestor asserted an `inherited_assumption` value (RFC 0021 §5).
-     * REQUIRED whenever `source` is `inherited_assumption`, and meaningless
+     * REQUIRED whenever `resolution` (or, pre-split, `source`) is
+     * `inherited_assumption`, and meaningless
      * otherwise — an inherited value with no named ancestor is indistinguishable
      * from an ambient default, which is exactly what §5 forbids.
      */
     inherited_from?: InheritedFrom;
 }
+/**
+ * A detached signature over a block's signing input (protocol §V.11).
+ *
+ * What it covers is deliberately narrow — `content_hash`, `section`, `actor`,
+ * `timestamp`, `kid`, `signed_at` — and deliberately excludes `parent_hash`.
+ * Signing is per-block authorship; chain integrity is the separate
+ * `content_hash`/`parent_hash` mechanism. Coupling them would make re-rooting a
+ * chain after a merge invalidate every prior signature, which is a legitimate
+ * edit destroying evidence it has no business touching.
+ */
+export interface UWBlockSignature {
+    /** Algorithm identifier. Closed set at protocol 1.x; see §V.11. */
+    alg: UWSignatureAlgorithm;
+    /** Opaque key identifier the verifier looks up in its own key store. */
+    kid: string;
+    /** Base64url-encoded (unpadded) signature bytes. */
+    sig: string;
+    /**
+     * ISO 8601 instant the signature was produced. MAY differ from
+     * `_meta.timestamp` — a block edited offline is signed when re-uploaded.
+     */
+    signed_at: string;
+    /** Signing-protocol version. Absent means `"1"`. */
+    v?: string;
+}
+/** The algorithms protocol 1.x admits for `_meta.signature.alg`. */
+export type UWSignatureAlgorithm = 'ed25519' | 'es256' | 'es384';
+/** Runtime mirror of {@link UWSignatureAlgorithm}, for validation. */
+export declare const UW_SIGNATURE_ALGORITHMS: readonly UWSignatureAlgorithm[];
 /** Identity and digest of the ancestor that asserted an inherited value. */
 export interface InheritedFrom {
     document_id: string;
@@ -176,7 +284,12 @@ export interface UWFrontmatter {
     city: string;
     state: string;
     zip: string;
-    asset_class: AssetClass;
+    /**
+     * Builtin, or a module-declared custom identifier (RFC 0003). A namespaced
+     * value obliges the file to name its modules in `modules` — see
+     * `declaredModuleDependencies`.
+     */
+    asset_class: UWAssetClassId;
     asset_subtype?: string | null;
     loan_type?: string | null;
     scenario?: string | null;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,5 +1,43 @@
 // .uw.md format — TypeScript type definitions
 // Spec: UW_FORMAT_SPEC_v1.md v1.1
+/**
+ * The full set of canonical short-form source tags. As of RFC 0031 these are
+ * the **resolution-method** vocabulary — producers stamp them into
+ * `_meta.resolution` (a tag found in `_meta.source` is legacy and is
+ * interpreted as `resolution` at read time). Eight of these match
+ * `CascadeStep` 1:1; the rest are non-cascade tags — `manual`,
+ * `ai_extracted`, `agent_computed`, `scenario_default`, and
+ * `market_data_accepted`.
+ *
+ * `market_data_accepted` (RFC 0022 §4) is deliberately *not* a cascade step:
+ * it is an in-file value of record that resolves at the `user_input` step
+ * while keeping its own tag, because a value accepted for lack of better
+ * evidence must stay distinguishable from one someone typed in.
+ *
+ * `scenario_default` is retained but its meaning is sharpened to mean
+ * "value derived from a named scenario in the file or institution
+ * config." Producers needing a generic fallback SHOULD use
+ * `system_default` instead.
+ *
+ * Actor patterns (`manual`, `agent/L6-01`, `document/rent_roll`, …) are a
+ * separate vocabulary — see `ACTOR_NAMESPACES` / `parseActorSource` in
+ * `protocol.ts`.
+ */
+export const SOURCE_TAGS = Object.freeze([
+    'user_input',
+    'user_override',
+    'manual',
+    'inherited_assumption',
+    'investor_profile',
+    'market_data',
+    'market_data_accepted',
+    'ai_extracted',
+    'agent_computed',
+    'asset_class_default',
+    'scenario_default',
+    'global_default',
+    'system_default',
+]);
 /**
  * Exhaustiveness anchor for {@link AssetClass}.
  *
@@ -34,6 +72,12 @@ const ASSET_CLASS_MEMBERS = {
  * `spec/UW_FORMAT_SPEC_v1.md` and `spec/schemas/`, not an independent registry.
  */
 export const ASSET_CLASSES = Object.freeze(Object.keys(ASSET_CLASS_MEMBERS));
+/** Runtime mirror of {@link UWSignatureAlgorithm}, for validation. */
+export const UW_SIGNATURE_ALGORITHMS = Object.freeze([
+    'ed25519',
+    'es256',
+    'es384',
+]);
 export const DEFAULT_THRESHOLDS = {
     dscr: { error_below: 1.0, warning_below: 1.2 },
     ltv: { warning_above: 0.75, error_above: 0.85 },

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,kCAAkC;AAkElC;;;;;;;;;;;;GAYG;AACH,MAAM,mBAAmB,GAA6B;IACpD,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;IACrB,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAA0B,MAAM,CAAC,MAAM,CAC/D,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAiB,CACjD,CAAC;AAsQF,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,IAAI,EAAe,EAAE,WAAW,EAAE,GAAG,EAAG,aAAa,EAAE,GAAG,EAAE;IAC5D,GAAG,EAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IAC7D,UAAU,EAAS,EAAE,aAAa,EAAE,IAAI,EAAE;IAC1C,QAAQ,EAAW,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,YAAY,EAAO,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,UAAU,EAAS,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,eAAe,EAAI,EAAE,aAAa,EAAE,GAAG,EAAG,aAAa,EAAE,GAAG,EAAE;IAC9D,kBAAkB,EAAC,EAAE,aAAa,EAAE,IAAI,EAAE;IAC1C,GAAG,EAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;CAC9D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,kCAAkC;AA2DlC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,YAAY;IACZ,eAAe;IACf,QAAQ;IACR,sBAAsB;IACtB,kBAAkB;IAClB,aAAa;IACb,sBAAsB;IACtB,cAAc;IACd,gBAAgB;IAChB,qBAAqB;IACrB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;CACR,CAAC,CAAC;AAiCZ;;;;;;;;;;;;GAYG;AACH,MAAM,mBAAmB,GAA6B;IACpD,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;IACrB,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAA0B,MAAM,CAAC,MAAM,CAC/D,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAiB,CACjD,CAAC;AAmJF,sEAAsE;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,SAAS;IACT,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAyLH,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,IAAI,EAAe,EAAE,WAAW,EAAE,GAAG,EAAG,aAAa,EAAE,GAAG,EAAE;IAC5D,GAAG,EAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IAC7D,UAAU,EAAS,EAAE,aAAa,EAAE,IAAI,EAAE;IAC1C,QAAQ,EAAW,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,YAAY,EAAO,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,UAAU,EAAS,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/D,eAAe,EAAI,EAAE,aAAa,EAAE,GAAG,EAAG,aAAa,EAAE,GAAG,EAAE;IAC9D,kBAAkB,EAAC,EAAE,aAAa,EAAE,IAAI,EAAE;IAC1C,GAAG,EAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;CAC9D,CAAC"}

package/dist/validator.d.ts

@@ -1,4 +1,4 @@
-import type { ParsedUWFile, ValidationMessage, ValidationResult, FinancialThresholds, DealStage } from './types.js';
+import type { ParsedUWFile, ValidationMessage, ValidationResult, FinancialThresholds, AssetClass, DealStage } from './types.js';
 import type { IssueRemediation, IncompleteDataPolicy } from './protocol.js';
 export declare function lookupRemediation(code: string): IssueRemediation | undefined;
 /**
@@ -20,9 +20,33 @@ export declare const STAGE_REQUIREMENTS: Record<DealStage, StageRequirement>;
  * Legacy helper that returns just the section-list portion of a stage's
  * requirements. Preserved for callers that pre-date the widened
  * `StageRequirement` shape; new code SHOULD consult `STAGE_REQUIREMENTS`
- * directly.
+ * directly (or `requiredSectionsFor` when the asset class is known).
  */
 export declare function getRequiredSections(stage: DealStage): readonly string[];
+/**
+ * Per-class adjustments to the base stage lists (format spec §5.1 class
+ * overlays, RFC 0029). Exhaustive by design: only `land` and `mixed_use`
+ * diverge structurally — every other class reuses the base sections with
+ * class-appropriate payloads (hospitality's `rent_roll` carries
+ * keys/ADR/segmentation), so reuse needs no entry here.
+ *
+ * `exempt` removes a requirement outright; `substitute` replaces it with
+ * another section that is then *required* in its place.
+ */
+export declare const STAGE_SECTION_OVERLAYS: Partial<Record<AssetClass, {
+    exempt?: readonly string[];
+    substitute?: Readonly<Record<string, string>>;
+}>>;
+/**
+ * The sections a declared stage requires of a document of the given asset
+ * class: the base list with the class overlay applied. A substitute that
+ * replaces more than one section appears once. An unrecognized class — or
+ * none — takes the base list verbatim. Both consumers of stage completeness
+ * (`stage_readiness` and `DQ-06`) resolve through this one function, so the
+ * booleans and the issues stream can never disagree about what a stage
+ * requires.
+ */
+export declare function requiredSectionsFor(stage: DealStage, assetClass?: string): readonly string[];
 export declare function validateUWFile(parsed: ParsedUWFile, thresholdOverrides?: Partial<FinancialThresholds>): ValidationResult;
 interface DataQualityOptions {
     policies?: readonly IncompleteDataPolicy[];

package/dist/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EAEnB,SAAS,EACV,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAgB5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5E;AA4CD;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAYlE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAEvE;AAqBD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAChD,gBAAgB,CAoClB;AAssBD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,iBAAiB,EAAE,EAC3B,IAAI,GAAE,kBAAuB,GAC5B,IAAI,CAkGN"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EAEnB,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAiB5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5E;AA4CD;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAelE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAEvE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE;IAC9D,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/C,CAAC,CAGD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAW5F;AAqBD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAChD,gBAAgB,CAuClB;AA21BD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,iBAAiB,EAAE,EAC3B,IAAI,GAAE,kBAAuB,GAC5B,IAAI,CAmGN"}

package/dist/validator.js

@@ -1,11 +1,12 @@
 // .uw.md validator — financial validity checks (§5.2) + cross-section consistency (§5.3)
 // Spec: UW_FORMAT_SPEC_v1.md Part V
-import { DEFAULT_THRESHOLDS } from './types.js';
+import { DEFAULT_THRESHOLDS, SOURCE_TAGS } from './types.js';
 import { getSection, getSectionVariant, deepGet } from './parser.js';
-import { BUILTIN_REMEDIATIONS, BUILTIN_INCOMPLETE_DATA_POLICIES, lookupIncompleteDataPolicy, getSizeIntensive, DEAL_UNDERWRITING_PROFILE } from './protocol.js';
+import { BUILTIN_REMEDIATIONS, BUILTIN_INCOMPLETE_DATA_POLICIES, lookupIncompleteDataPolicy, getSizeIntensive, DEAL_UNDERWRITING_PROFILE, parseActorSource } from './protocol.js';
 import { EXTERNAL_ANNOTATION_KEY } from './composition.js';
 import { UW_LITE_SOURCE_EXTENSION } from './lite-bridge.js';
 import { readGapsContent } from './gaps.js';
+import { parseAssetClass, declaredModuleDependencies } from './asset-class.js';
 // ─── BUILTIN_REMEDIATIONS lookup (UW_PROTOCOL_v1.md §III.6) ──────────────────
 //
 // Validator constructs inline messages with deal-specific values, but the
@@ -66,20 +67,61 @@ export const STAGE_REQUIREMENTS = {
     },
     screening: { required_sections: ['property', 'debt_structure', 'validation'] },
     term_sheet: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing'] },
-    full_underwrite: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'noi_model', 'valuation', 'sources_uses', 'market_analysis'] },
-    credit_approval: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'noi_model', 'valuation', 'sources_uses', 'market_analysis', 'dcf', 'stress_tests', 'risk_assessment', 'compliance', 'assumptions'] },
-    closing: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'noi_model', 'valuation', 'sources_uses', 'market_analysis', 'dcf', 'stress_tests', 'risk_assessment', 'compliance', 'assumptions', 'due_diligence'] },
-    monitoring: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'noi_model', 'valuation', 'sources_uses', 'market_analysis', 'dcf', 'stress_tests', 'risk_assessment', 'compliance', 'assumptions', 'due_diligence'] },
+    // `operating_statement` re-joined full_underwrite and above with RFC 0028
+    // (spec §5.1 always listed it; the variant-aware `hasSection` case below
+    // was built for it but no stage list reached it — decision (a) in the RFC).
+    full_underwrite: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'operating_statement', 'noi_model', 'valuation', 'sources_uses', 'market_analysis'] },
+    credit_approval: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'operating_statement', 'noi_model', 'valuation', 'sources_uses', 'market_analysis', 'dcf', 'stress_tests', 'risk_assessment', 'compliance', 'assumptions'] },
+    closing: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'operating_statement', 'noi_model', 'valuation', 'sources_uses', 'market_analysis', 'dcf', 'stress_tests', 'risk_assessment', 'compliance', 'assumptions', 'due_diligence'] },
+    monitoring: { required_sections: ['property', 'debt_structure', 'validation', 'rent_roll', 'borrower_sponsor', 'preliminary_sizing', 'operating_statement', 'noi_model', 'valuation', 'sources_uses', 'market_analysis', 'dcf', 'stress_tests', 'risk_assessment', 'compliance', 'assumptions', 'due_diligence'] },
 };
 /**
  * Legacy helper that returns just the section-list portion of a stage's
  * requirements. Preserved for callers that pre-date the widened
  * `StageRequirement` shape; new code SHOULD consult `STAGE_REQUIREMENTS`
- * directly.
+ * directly (or `requiredSectionsFor` when the asset class is known).
  */
 export function getRequiredSections(stage) {
     return STAGE_REQUIREMENTS[stage].required_sections;
 }
+/**
+ * Per-class adjustments to the base stage lists (format spec §5.1 class
+ * overlays, RFC 0029). Exhaustive by design: only `land` and `mixed_use`
+ * diverge structurally — every other class reuses the base sections with
+ * class-appropriate payloads (hospitality's `rent_roll` carries
+ * keys/ADR/segmentation), so reuse needs no entry here.
+ *
+ * `exempt` removes a requirement outright; `substitute` replaces it with
+ * another section that is then *required* in its place.
+ */
+export const STAGE_SECTION_OVERLAYS = {
+    land: { exempt: ['rent_roll', 'operating_statement'] },
+    mixed_use: { substitute: { rent_roll: 'components', operating_statement: 'components' } },
+};
+/**
+ * The sections a declared stage requires of a document of the given asset
+ * class: the base list with the class overlay applied. A substitute that
+ * replaces more than one section appears once. An unrecognized class — or
+ * none — takes the base list verbatim. Both consumers of stage completeness
+ * (`stage_readiness` and `DQ-06`) resolve through this one function, so the
+ * booleans and the issues stream can never disagree about what a stage
+ * requires.
+ */
+export function requiredSectionsFor(stage, assetClass) {
+    const base = STAGE_REQUIREMENTS[stage].required_sections;
+    const overlay = assetClass ? STAGE_SECTION_OVERLAYS[assetClass] : undefined;
+    if (!overlay)
+        return base;
+    const out = [];
+    for (const section of base) {
+        if (overlay.exempt?.includes(section))
+            continue;
+        const replacement = overlay.substitute?.[section] ?? section;
+        if (!out.includes(replacement))
+            out.push(replacement);
+    }
+    return out;
+}
 /**
  * Resolve a dot-notated path of the form `<section>.<field>...` against
  * the parsed file's content blocks. Returns `undefined` when any segment
@@ -107,7 +149,10 @@ export function validateUWFile(parsed, thresholdOverrides) {
     checkComponents(parsed, issues);
     checkCapitalStack(parsed, issues);
     checkSizeIntensive(parsed, issues);
+    checkSectionReadiness(parsed, issues);
+    checkAssetClassIdentifier(parsed, issues);
     checkMetaIntegrity(parsed, issues);
+    checkSourceVocabulary(parsed, issues);
     checkScopeReadiness(parsed, issues);
     checkDataQuality(parsed, issues);
     // Enrich every issue with BUILTIN_REMEDIATIONS title/remediation/spec_ref
@@ -638,6 +683,53 @@ function checkSizeIntensive(parsed, issues) {
         value: value ?? null,
     });
 }
+// ─── §5.3 CC-14 / §III.6a DQ-06 — section-level readiness (RFC 0028) ─────────
+// CC-14 warns when a deal-record UWX document has no property section at all
+// — §4.1 requires it at every stage, and before this rule the only trace of
+// the gap was a stage_readiness boolean nothing downstream reads. Always a
+// warning, never an error: the RFC 0028 Appendix A scan found 28 corpus
+// documents a refusal would invalidate retroactively, and an institution
+// wanting a hard gate has INCOMPLETE_DATA_POLICIES.
+//
+// DQ-06 then names, at info severity, each section the declared deal_stage
+// requires but the file lacks — the sectional sibling of the field-level
+// DQ-04, and the issues-stream mirror of stage_readiness. Info because the
+// same scan shows deal_stage declarations state where a deal is going, not
+// what the file contains (all twelve worked examples fail their declared
+// stage's list); info reports the gap without refusing or nagging.
+function checkSectionReadiness(parsed, issues) {
+    // CC-14 preconditions mirror CC-13's 1 and 2 (RFC 0028 §1). Precondition 3
+    // (not externalized) is satisfied structurally: an externalized-but-
+    // unresolved section still parses as a block, so it is present here.
+    const isCompiledLite = !!(parsed.sections[UW_LITE_SOURCE_EXTENSION] || parsed.extensions?.[UW_LITE_SOURCE_EXTENSION]);
+    const profile = parsed.frontmatter['document_profile'];
+    const isDealRecord = profile == null || profile === DEAL_UNDERWRITING_PROFILE;
+    const hasProperty = hasStageSection(parsed, 'property');
+    let cc14Fired = false;
+    if (!isCompiledLite && isDealRecord && !hasProperty) {
+        cc14Fired = true;
+        issues.push({
+            code: 'CC-14', severity: 'warning', section: 'property',
+            message: 'CC-14: this deal record has no property section; §4.1 requires it at every stage',
+        });
+    }
+    // DQ-06: one issue per missing required section of the declared stage.
+    // No stage declared → no claim to check (same posture as DQ-04). The
+    // property entry is suppressed when CC-14 fired: one defect, one diagnostic.
+    const stage = parsed.frontmatter.deal_stage;
+    if (!stage || !(stage in STAGE_REQUIREMENTS))
+        return;
+    for (const sectionId of requiredSectionsFor(stage, parsed.frontmatter.asset_class)) {
+        if (sectionId === 'property' && cc14Fired)
+            continue;
+        if (hasStageSection(parsed, sectionId))
+            continue;
+        issues.push({
+            code: 'DQ-06', severity: 'info', section: sectionId,
+            message: `DQ-06: ${stage} requires ${sectionId}; section is missing.`,
+        });
+    }
+}
 function checkCapitalStack(parsed, issues) {
     const cs = getSection(parsed, 'capital_stack');
     if (cs)
@@ -654,6 +746,50 @@ function checkCapitalStack(parsed, issues) {
         }
     }
 }
+// ─── Asset-class identifier (RFC 0003) ───────────────────────────────────────
+/**
+ * The identifier itself, independent of whether any module is loaded.
+ *
+ * Deliberately separate from *resolution*: whether a custom class can be read
+ * depends on the host's loaded modules, and a validator that conflated the two
+ * would report the same file as valid or invalid depending on who ran it.
+ * What is checked here is the part that is true everywhere — the syntax, and
+ * the obligation a namespaced class carries to name its modules.
+ */
+function checkAssetClassIdentifier(parsed, issues) {
+    const raw = parsed.frontmatter?.asset_class;
+    if (typeof raw !== 'string' || raw.length === 0)
+        return;
+    const identity = parseAssetClass(raw);
+    if (!identity.ok) {
+        issues.push({
+            code: identity.error.code,
+            severity: 'error',
+            field: 'asset_class',
+            message: identity.error.message,
+            value: raw,
+            ...(identity.error.remediation ? { remediation: identity.error.remediation } : {}),
+        });
+        return;
+    }
+    if (identity.kind === 'builtin')
+        return;
+    // A namespaced class with no `modules` list is unreadable by anyone who does
+    // not already happen to hold the right module: the file states a dependency
+    // it never names. Reported as a warning rather than an error because the
+    // document is still well-formed and a host that does hold the module reads
+    // it correctly — the cost falls on everyone else.
+    if (declaredModuleDependencies(parsed.frontmatter).length === 0) {
+        issues.push({
+            code: 'MOD-DEPENDENCY-UNDECLARED',
+            severity: 'warning',
+            field: 'modules',
+            message: `asset_class '${raw}' is module-declared, but frontmatter names no 'modules' to load.`,
+            value: raw,
+            remediation: `Add a 'modules' list naming the module that declares '${raw}', so a reader without it can say what to load rather than only that something is missing.`,
+        });
+    }
+}
 // ─── Meta integrity checks ────────────────────────────────────────────────────
 function checkMetaIntegrity(parsed, issues) {
     const REQUIRED_META_FIELDS = ['section', 'version', 'source', 'timestamp', 'confidence'];
@@ -683,24 +819,70 @@ function checkMetaIntegrity(parsed, issues) {
         }
     }
 }
+// ─── SRC-01 / SRC-02: source vocabulary (RFC 0031) ───────────────────────────
+//
+// `_meta.source` is actor-only: `manual` or `<namespace>/<id>` with a
+// registered namespace. SRC-02 fires when the field holds a canonical
+// SOURCE_TAGS value — a resolution method in the actor field, the pre-split
+// spelling, read-time-interpreted as `resolution` (warning through format
+// 1.x, error at 2.0). SRC-01 fires on everything else outside the grammar
+// (colon forms, bare words). Both are warnings: every such block still
+// parses, and edits against it resolve the conservative catch-all policy.
+const NON_MANUAL_SOURCE_TAGS = new Set(SOURCE_TAGS.filter((t) => t !== 'manual'));
+function checkSourceVocabulary(parsed, issues) {
+    for (const [sectionId, entry] of Object.entries(parsed.sections)) {
+        const blocks = isVariantMap(entry)
+            ? Object.values(entry)
+            : [entry];
+        for (const block of blocks) {
+            const src = block.meta?.source;
+            if (typeof src !== 'string' || src.length === 0)
+                continue; // absence is META/DQ territory
+            if (NON_MANUAL_SOURCE_TAGS.has(src)) {
+                issues.push({
+                    code: 'SRC-02',
+                    severity: 'warning',
+                    section: sectionId,
+                    message: `Section ${sectionId} _meta.source is '${src}', a resolution tag in the actor field. Move it to _meta.resolution; readers treat the actor as absent.`,
+                });
+                continue;
+            }
+            if (parseActorSource(src).kind === 'invalid') {
+                issues.push({
+                    code: 'SRC-01',
+                    severity: 'warning',
+                    section: sectionId,
+                    message: `Section ${sectionId} _meta.source '${src}' is not 'manual' or '<namespace>/<id>' with a registered actor namespace (${['agent', 'document', 'system', 'institution'].join(', ')}).`,
+                });
+            }
+        }
+    }
+}
 // ─── Stage readiness ──────────────────────────────────────────────────────────
+/**
+ * Variant-aware section presence, as stage readiness defines it: a
+ * multi-variant `operating_statement` counts through its `t12` or `default`
+ * variant. Shared by `computeStageReadiness` and the RFC 0028 checks
+ * (`CC-14`, `DQ-06`) so "present" means one thing.
+ */
+function hasStageSection(parsed, id) {
+    if (id === 'operating_statement') {
+        return !!(parsed.sections[id] || getSectionVariant(parsed, id, 't12') || getSectionVariant(parsed, id, 'default'));
+    }
+    return !!parsed.sections[id];
+}
 function computeStageReadiness(parsed) {
-    const hasSection = (id) => {
-        if (id === 'operating_statement') {
-            return !!(parsed.sections[id] || getSectionVariant(parsed, id, 't12') || getSectionVariant(parsed, id, 'default'));
-        }
-        if (id === 'stress_tests' || id === 'due_diligence') {
-            return !!(parsed.sections[id]);
-        }
-        return !!parsed.sections[id];
-    };
+    const hasSection = (id) => hasStageSection(parsed, id);
     const hasFieldPath = (path) => {
         const v = resolveSectionFieldPath(parsed, path);
         return v !== undefined && v !== null && v !== '';
     };
     const stageReady = (stage) => {
         const req = STAGE_REQUIREMENTS[stage];
-        if (!req.required_sections.every(s => hasSection(s)))
+        // Class overlays (RFC 0029): resolve through the same function DQ-06
+        // uses, so readiness and the issues stream cannot disagree.
+        const requiredSections = requiredSectionsFor(stage, parsed.frontmatter.asset_class);
+        if (!requiredSections.every(s => hasSection(s)))
             return false;
         if (req.required_field_paths && !req.required_field_paths.every(hasFieldPath))
             return false;
@@ -828,8 +1010,8 @@ export function checkDataQuality(parsed, issues, opts = {}) {
             // accepted but never recover which observations, of which vintage. That
             // is precisely the gap the profile exists to close, so a block asserting
             // the tag without the reference is worse than one tagged plainly.
-            const promoted = m.source === 'market_data_accepted' ||
-                m.field_overrides?.some((o) => o.source === 'market_data_accepted');
+            const promotedTag = (o) => o.resolution === 'market_data_accepted' || o.source === 'market_data_accepted';
+            const promoted = promotedTag(m) || m.field_overrides?.some(promotedTag);
             if (promoted && !m.market_data_ref) {
                 issues.push({
                     code: 'DQ-06',