@mj-biz-apps/contracts-ng 0.4.1 → 0.5.0

package/dist/lib/data/entity-names.d.ts

@@ -29,5 +29,43 @@ export declare const MJC_FOREIGN_ENTITIES: {
     readonly File: "MJ: Files";
     readonly FileCategory: "MJ: File Categories";
     readonly FileEntityRecordLink: "MJ: File Entity Record Links";
+    /**
+     * bizapps-SALES, and read SOFTLY — no manifest dependency, deliberately (golive #219).
+     *
+     * Sales depends on THIS app: its Close-Won seam is what creates contracts. That is precisely why
+     * a contract's provenance is the polymorphic `CreatingEntityID` / `CreatingRecordID` pair rather
+     * than a `DealID` column — a hard reference upward would invert the dependency graph, and the
+     * Contract entity's own description says so in as many words.
+     *
+     * So this is a NAME resolved from provider metadata at runtime and nothing more. No import, no
+     * entry in `mj-app.json`. An installation without sales finds no such entity, and the Source-record
+     * picker does not render — a supported state, not a failure.
+     */
+    readonly Deal: "MJ_BizApps_Sales: Deals";
+    /**
+     * bizapps-tasks. Read for the "To process" tile and the "Has open task" pill — the finance flow
+     * (S-US2 / C-US2) is task-driven, which is why `mj-app.json` declares tasks a real dependency
+     * rather than an optional read.
+     *
+     * ⚠ These belong in `@mj-biz-apps/tasks-entities` and are here only because that package exports
+     * generated entity subclasses and nothing else — the names live as private consts scattered
+     * across four repos today. When tasks exports them, delete these three and import instead.
+     */
+    readonly Task: "MJ_BizApps_Tasks: Tasks";
+    readonly TaskLink: "MJ_BizApps_Tasks: Task Links";
+    readonly TaskType: "MJ_BizApps_Tasks: Task Types";
 };
+/**
+ * Stored queries this app owns, addressed by name the way entities are.
+ *
+ * `RunQuery` resolves by NAME plus category path, so these strings carry the same typo hazard the
+ * entity names do — wrong by one character and the tile renders an em dash at runtime with nothing
+ * failing to compile. The rows live in `metadata/queries/`; the category in `metadata/query-categories/`.
+ */
+export declare const MJC_QUERIES: {
+    /** Distinct customers with an in-force modified agreement, and how many contracts that spans. */
+    readonly SpecialTerms: "Contracts Special Terms";
+};
+/** The category every query above hangs under — `RunQuery`'s `CategoryPath`. */
+export declare const MJC_QUERY_CATEGORY = "Contracts";
 //# sourceMappingURL=entity-names.d.ts.map

package/dist/lib/data/entity-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-names.d.ts","sourceRoot":"","sources":["../../../src/lib/data/entity-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,oBAAoB;;;IAG7B,sFAAsF;;IAEtF,4GAA4G;;;;CAItG,CAAC"}
+{"version":3,"file":"entity-names.d.ts","sourceRoot":"","sources":["../../../src/lib/data/entity-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,oBAAoB;;;IAG7B,sFAAsF;;IAEtF,4GAA4G;;;;IAI5G;;;;;;;;;;;OAWG;;IAEH;;;;;;;;OAQG;;;;CAIG,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;IACpB,iGAAiG;;CAE3F,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,cAAc,CAAC"}

package/dist/lib/data/entity-names.js

@@ -29,5 +29,43 @@ export const MJC_FOREIGN_ENTITIES = {
     File: 'MJ: Files',
     FileCategory: 'MJ: File Categories',
     FileEntityRecordLink: 'MJ: File Entity Record Links',
+    /**
+     * bizapps-SALES, and read SOFTLY — no manifest dependency, deliberately (golive #219).
+     *
+     * Sales depends on THIS app: its Close-Won seam is what creates contracts. That is precisely why
+     * a contract's provenance is the polymorphic `CreatingEntityID` / `CreatingRecordID` pair rather
+     * than a `DealID` column — a hard reference upward would invert the dependency graph, and the
+     * Contract entity's own description says so in as many words.
+     *
+     * So this is a NAME resolved from provider metadata at runtime and nothing more. No import, no
+     * entry in `mj-app.json`. An installation without sales finds no such entity, and the Source-record
+     * picker does not render — a supported state, not a failure.
+     */
+    Deal: 'MJ_BizApps_Sales: Deals',
+    /**
+     * bizapps-tasks. Read for the "To process" tile and the "Has open task" pill — the finance flow
+     * (S-US2 / C-US2) is task-driven, which is why `mj-app.json` declares tasks a real dependency
+     * rather than an optional read.
+     *
+     * ⚠ These belong in `@mj-biz-apps/tasks-entities` and are here only because that package exports
+     * generated entity subclasses and nothing else — the names live as private consts scattered
+     * across four repos today. When tasks exports them, delete these three and import instead.
+     */
+    Task: 'MJ_BizApps_Tasks: Tasks',
+    TaskLink: 'MJ_BizApps_Tasks: Task Links',
+    TaskType: 'MJ_BizApps_Tasks: Task Types',
 };
+/**
+ * Stored queries this app owns, addressed by name the way entities are.
+ *
+ * `RunQuery` resolves by NAME plus category path, so these strings carry the same typo hazard the
+ * entity names do — wrong by one character and the tile renders an em dash at runtime with nothing
+ * failing to compile. The rows live in `metadata/queries/`; the category in `metadata/query-categories/`.
+ */
+export const MJC_QUERIES = {
+    /** Distinct customers with an in-force modified agreement, and how many contracts that spans. */
+    SpecialTerms: 'Contracts Special Terms',
+};
+/** The category every query above hangs under — `RunQuery`'s `CategoryPath`. */
+export const MJC_QUERY_CATEGORY = 'Contracts';
 //# sourceMappingURL=entity-names.js.map

package/dist/lib/data/entity-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-names.js","sourceRoot":"","sources":["../../../src/lib/data/entity-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,QAAQ,EAAE,iCAAiC;IAC3C,YAAY,EAAE,sCAAsC;IACpD,gBAAgB,EAAE,0CAA0C;IAC5D,oBAAoB,EAAE,+CAA+C;IACrE,yBAAyB,EAAE,oDAAoD;IAC/E,4BAA4B,EAAE,uDAAuD;CAC/E,CAAC;AAEX,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,YAAY,EAAE,kCAAkC;IAChD,MAAM,EAAE,2BAA2B;IACnC,sFAAsF;IACtF,OAAO,EAAE,eAAe;IACxB,4GAA4G;IAC5G,IAAI,EAAE,WAAW;IACjB,YAAY,EAAE,qBAAqB;IACnC,oBAAoB,EAAE,8BAA8B;CAC9C,CAAC"}
+{"version":3,"file":"entity-names.js","sourceRoot":"","sources":["../../../src/lib/data/entity-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,QAAQ,EAAE,iCAAiC;IAC3C,YAAY,EAAE,sCAAsC;IACpD,gBAAgB,EAAE,0CAA0C;IAC5D,oBAAoB,EAAE,+CAA+C;IACrE,yBAAyB,EAAE,oDAAoD;IAC/E,4BAA4B,EAAE,uDAAuD;CAC/E,CAAC;AAEX,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,YAAY,EAAE,kCAAkC;IAChD,MAAM,EAAE,2BAA2B;IACnC,sFAAsF;IACtF,OAAO,EAAE,eAAe;IACxB,4GAA4G;IAC5G,IAAI,EAAE,WAAW;IACjB,YAAY,EAAE,qBAAqB;IACnC,oBAAoB,EAAE,8BAA8B;IACpD;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,yBAAyB;IAC/B;;;;;;;;OAQG;IACH,IAAI,EAAE,yBAAyB;IAC/B,QAAQ,EAAE,8BAA8B;IACxC,QAAQ,EAAE,8BAA8B;CAClC,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,iGAAiG;IACjG,YAAY,EAAE,yBAAyB;CACjC,CAAC;AAEX,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC"}

package/dist/lib/data/task-filters.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview The one definition of "this contract has an open processing task".
+ *
+ * WHY THIS IS A FILE AND NOT TWO INLINE STRINGS. The dashboard's "To process" tile and the All
+ * Contracts "Has open task" pill must count the same rows — the tile's entire promise is that
+ * clicking it lands on the list it just counted. Written twice they agree until one is edited, and
+ * the failure is silent: a tile saying 7 over a list showing 5 reads as a stale page rather than a
+ * bug. One exported builder, two callers.
+ *
+ * ## Why a correlated subquery rather than three reads
+ *
+ * Tasks live in ANOTHER APP's schema, and `Task Links` carries `EntityID` / `RecordID` while the
+ * status and due date live on `Tasks`. There is no single view to filter, so the alternatives are a
+ * SQL `EXISTS` inside `ExtraFilter`, or reading task ids into memory and passing `ID IN (…)`. The
+ * second is not a worklist filter — an `IN` list has to be capped, and a capped filter quietly hides
+ * work, which is the one thing a work queue must not do.
+ *
+ * `ExtraFilter` is raw SQL appended to the base view's WHERE, so the subquery is legal. MJ screens
+ * it with a keyword denylist (`DatabaseProviderBase.ValidateUserProvidedSQLClause`) covering
+ * `insert / update / delete / exec / drop / -- / union / xp_ / ; / waitfor` — `SELECT`, `EXISTS` and
+ * `JOIN` are not on it. (The stricter validator that DOES block `EXISTS` governs aggregate
+ * expressions, not filters.) The base view is selected without an alias, so `vwContracts.ID` is a
+ * legal correlated reference.
+ *
+ * ## ⚠ Two consequences worth knowing before this pattern spreads
+ *
+ * **It bypasses MJ's permission and RLS model for Tasks.** MJ applies entity permissions and row
+ * filters to the entity being *read* — here, Contracts. Nothing checks the reader against Tasks, so
+ * a user with no access to Tasks still gets a count shaped by them. That is an acceptable trade for
+ * a COUNT of the reader's own contracts, and it is the reason not to extend this to reading task
+ * rows: the moment task content reaches the screen, it must go through a Tasks read.
+ *
+ * **Nothing here is hardcoded except the type code.** Schema and view names come from MJ's metadata
+ * rather than string literals, so an app that is not installed produces `null` (and a dashboard tile
+ * that renders "—") instead of SQL naming a schema that does not exist.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { type IMetadataProvider } from '@memberjunction/core';
+/**
+ * The task type sales raises on Close-Won for finance to work through.
+ *
+ * Addressed by CODE, not by name or id: the row is seeded by bizapps-sales
+ * (`metadata/task-types/.task-types.json`) and `CloseWonTaskService` writes this exact code, so the
+ * code is the contract between the two apps. A display name is content and can be edited; an id
+ * differs per database.
+ */
+export declare const MJC_TASK_CODE_CONTRACT_PROCESSING = "CONTRACT_PROCESSING";
+/** The two filter fragments the dashboard and the pill share. */
+export interface MJCOpenTaskFilters {
+    /** Contracts with at least one open Contract Processing task. */
+    HasOpenTask: string;
+    /** The same, narrowed to tasks whose due date has passed. */
+    HasOverdueTask: string;
+}
+/**
+ * Build the shared fragments, or `null` when they cannot be built.
+ *
+ * `null` is returned — rather than a filter that matches nothing — when bizapps-tasks is not
+ * installed, or when the CONTRACT_PROCESSING type row is missing. The distinction matters at the
+ * call site: a filter matching nothing renders a confident `0`, while `null` lets the caller render
+ * "—". "We cannot tell" and "there is no work" are different answers, and only one of them is safe
+ * to show a person whose job is working the queue.
+ */
+export declare function BuildOpenTaskFilters(provider?: IMetadataProvider | null): Promise<MJCOpenTaskFilters | null>;
+//# sourceMappingURL=task-filters.d.ts.map

package/dist/lib/data/task-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-filters.d.ts","sourceRoot":"","sources":["../../../src/lib/data/task-filters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIxE;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,wBAAwB,CAAC;AAKvE,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IAC/B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAqCpC"}

package/dist/lib/data/task-filters.js

@@ -0,0 +1,124 @@
+/**
+ * @fileoverview The one definition of "this contract has an open processing task".
+ *
+ * WHY THIS IS A FILE AND NOT TWO INLINE STRINGS. The dashboard's "To process" tile and the All
+ * Contracts "Has open task" pill must count the same rows — the tile's entire promise is that
+ * clicking it lands on the list it just counted. Written twice they agree until one is edited, and
+ * the failure is silent: a tile saying 7 over a list showing 5 reads as a stale page rather than a
+ * bug. One exported builder, two callers.
+ *
+ * ## Why a correlated subquery rather than three reads
+ *
+ * Tasks live in ANOTHER APP's schema, and `Task Links` carries `EntityID` / `RecordID` while the
+ * status and due date live on `Tasks`. There is no single view to filter, so the alternatives are a
+ * SQL `EXISTS` inside `ExtraFilter`, or reading task ids into memory and passing `ID IN (…)`. The
+ * second is not a worklist filter — an `IN` list has to be capped, and a capped filter quietly hides
+ * work, which is the one thing a work queue must not do.
+ *
+ * `ExtraFilter` is raw SQL appended to the base view's WHERE, so the subquery is legal. MJ screens
+ * it with a keyword denylist (`DatabaseProviderBase.ValidateUserProvidedSQLClause`) covering
+ * `insert / update / delete / exec / drop / -- / union / xp_ / ; / waitfor` — `SELECT`, `EXISTS` and
+ * `JOIN` are not on it. (The stricter validator that DOES block `EXISTS` governs aggregate
+ * expressions, not filters.) The base view is selected without an alias, so `vwContracts.ID` is a
+ * legal correlated reference.
+ *
+ * ## ⚠ Two consequences worth knowing before this pattern spreads
+ *
+ * **It bypasses MJ's permission and RLS model for Tasks.** MJ applies entity permissions and row
+ * filters to the entity being *read* — here, Contracts. Nothing checks the reader against Tasks, so
+ * a user with no access to Tasks still gets a count shaped by them. That is an acceptable trade for
+ * a COUNT of the reader's own contracts, and it is the reason not to extend this to reading task
+ * rows: the moment task content reaches the screen, it must go through a Tasks read.
+ *
+ * **Nothing here is hardcoded except the type code.** Schema and view names come from MJ's metadata
+ * rather than string literals, so an app that is not installed produces `null` (and a dashboard tile
+ * that renders "—") instead of SQL naming a schema that does not exist.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { Metadata } from '@memberjunction/core';
+import { MJC_ENTITIES, MJC_FOREIGN_ENTITIES } from './entity-names';
+import { ScopedRunView } from './provider';
+/**
+ * The task type sales raises on Close-Won for finance to work through.
+ *
+ * Addressed by CODE, not by name or id: the row is seeded by bizapps-sales
+ * (`metadata/task-types/.task-types.json`) and `CloseWonTaskService` writes this exact code, so the
+ * code is the contract between the two apps. A display name is content and can be edited; an id
+ * differs per database.
+ */
+export const MJC_TASK_CODE_CONTRACT_PROCESSING = 'CONTRACT_PROCESSING';
+/** Statuses that mean the task is done with, in the Tasks app's own vocabulary. */
+const CLOSED_TASK_STATUSES = ['Completed', 'Cancelled'];
+/**
+ * Build the shared fragments, or `null` when they cannot be built.
+ *
+ * `null` is returned — rather than a filter that matches nothing — when bizapps-tasks is not
+ * installed, or when the CONTRACT_PROCESSING type row is missing. The distinction matters at the
+ * call site: a filter matching nothing renders a confident `0`, while `null` lets the caller render
+ * "—". "We cannot tell" and "there is no work" are different answers, and only one of them is safe
+ * to show a person whose job is working the queue.
+ */
+export async function BuildOpenTaskFilters(provider) {
+    const entities = (provider ?? Metadata.Provider)?.Entities ?? [];
+    const contracts = entities.find((e) => e.Name === MJC_ENTITIES.Contract);
+    const taskLinks = entities.find((e) => e.Name === MJC_FOREIGN_ENTITIES.TaskLink);
+    const tasks = entities.find((e) => e.Name === MJC_FOREIGN_ENTITIES.Task);
+    // Any of these missing means the Tasks app is not on this host. Not an error — contracts is
+    // installable without it, and the tile simply has nothing to say.
+    if (!contracts?.ID || !taskLinks?.BaseView || !tasks?.BaseView)
+        return null;
+    const typeID = await resolveContractProcessingTypeID(provider);
+    if (!typeID)
+        return null;
+    const linkView = qualified(taskLinks.SchemaName, taskLinks.BaseView);
+    const taskView = qualified(tasks.SchemaName, tasks.BaseView);
+    const contractView = qualified(contracts.SchemaName, contracts.BaseView);
+    const closed = CLOSED_TASK_STATUSES.map((s) => `'${s}'`).join(',');
+    /**
+     * `RecordID` is nvarchar — it holds a primary key of any shape, since a link can point at any
+     * entity — so the contract's uniqueidentifier is CAST rather than compared directly. Without the
+     * cast SQL Server applies its own conversion and the comparison becomes non-sargable at best.
+     */
+    const exists = (extra) => `EXISTS (SELECT 1 FROM ${linkView} tl ` +
+        `INNER JOIN ${taskView} t ON t.ID = tl.TaskID ` +
+        `WHERE tl.RecordID = CAST(${contractView}.ID AS nvarchar(255)) ` +
+        `AND tl.EntityID = '${contracts.ID}' ` +
+        `AND t.TypeID = '${typeID}' ` +
+        `AND t.Status NOT IN (${closed})${extra})`;
+    return {
+        HasOpenTask: exists(''),
+        // Date, not datetime: "overdue" is a whole-day judgement, and comparing against the current
+        // instant would call a task due later today overdue all morning.
+        HasOverdueTask: exists(' AND t.DueAt < CAST(GETUTCDATE() AS date)'),
+    };
+}
+/**
+ * Code → id, once.
+ *
+ * The Tasks base view exposes the type's NAME but not its CODE, so the id cannot be reached by
+ * filtering Tasks directly — it takes a read against Task Types. Comparing on the name instead would
+ * make an editable label load-bearing.
+ */
+async function resolveContractProcessingTypeID(provider) {
+    try {
+        const result = await ScopedRunView(provider).RunView({
+            EntityName: MJC_FOREIGN_ENTITIES.TaskType,
+            ExtraFilter: `Code = '${MJC_TASK_CODE_CONTRACT_PROCESSING}'`,
+            ResultType: 'simple',
+            Fields: ['ID'],
+            MaxRows: 1,
+        });
+        return result?.Success ? (result.Results?.[0]?.ID ?? null) : null;
+    }
+    catch {
+        // The entity exists but could not be read — same answer as "not installed" from here, and the
+        // caller renders "—" either way.
+        return null;
+    }
+}
+/** `[schema].[view]`, with the schema omitted when metadata does not carry one. */
+function qualified(schema, view) {
+    return schema ? `[${schema}].[${view}]` : `[${view}]`;
+}
+//# sourceMappingURL=task-filters.js.map

package/dist/lib/data/task-filters.js.map

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

package/dist/lib/form-panels/contract-form.panels.d.ts

@@ -1,7 +1,33 @@
+/**
+ * @fileoverview Contract form body — Overview plus organized rail sections.
+ *
+ * Replaces leftover generated field dumps (Contract Details, Stakeholders, Provenance,
+ * Lifecycle, Notes) with:
+ *   Overview (exec briefing) · Agreement · Parties · Dates · Renewal · Notes
+ *   Modifications · Lineage · Re-papering · Provenance
+ *
+ * Dates / Renewal / Lineage / Re-papering already live in sibling files.
+ * Files on a contract are MJ's stock attachments (form toolbar), not a custom Documents section.
+ * `contributionKey` equals each panel's `SectionKey`. Overview is the only
+ * `inclusion: 'Primary'` so it leads; the rest sort into the related band by sortKey.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { type OnInit } from '@angular/core';
 import { BaseFormPanel } from '@memberjunction/ng-base-forms';
 import type { AfterDataLoadEventArgs } from '@memberjunction/ng-entity-viewer';
-import { ContractEntity, type ContractState } from '@mj-biz-apps/contracts-entities';
+import { ContractEntity, type ContractState, type DealOption } from '@mj-biz-apps/contracts-entities';
 import * as i0 from "@angular/core";
+/**
+ * A deal option with its rendered label attached (golive #219).
+ *
+ * The label is computed ONCE per row, on load, rather than from a template call: `mj-combobox` reads
+ * `TextField` on every change-detection pass and for every option, so a function there re-renders the
+ * whole list on each keystroke.
+ */
+interface DealChoice extends DealOption {
+    Label: string;
+}
 type ContractFieldType = 'textbox' | 'textarea' | 'number' | 'datepicker' | 'checkbox' | 'select' | 'autocomplete' | 'code' | 'dropdownlist' | 'numerictextbox';
 interface ContractFieldSpec {
     name: string;
@@ -47,8 +73,71 @@ export declare class MJCContractOverviewPanel extends BaseFormPanel<ContractEnti
     static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractOverviewPanel, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractOverviewPanel, "mjc-contract-overview-panel", never, {}, {}, never, never, true, never>;
 }
-export declare class MJCContractAgreementPanel extends BaseFormPanel<ContractEntity> {
+export declare class MJCContractAgreementPanel extends BaseFormPanel<ContractEntity> implements OnInit {
+    private readonly cdr;
     readonly Fields: ContractFieldSpec[];
+    /**
+     * The template ID this panel last put in the field — how it tells its own default from a choice.
+     *
+     * Session-local on purpose: it is never read from the record, because the record cannot say who
+     * wrote a value into it. See `MayWriteDefaultTemplate`, which owns what it means.
+     */
+    private lastDefaultedID;
+    /**
+     * A contract that arrives with its type already set — Explorer's `NewRecordValues`, or a New
+     * clicked from a type-scoped list — gets its template here, before the form is ever drawn.
+     *
+     * The commoner path is a person choosing the type by hand, which never reaches `ngOnInit` and is
+     * why `OnFieldValueChange` exists too. Both call the same method; neither is sufficient alone.
+     */
+    ngOnInit(): Promise<void>;
+    /**
+     * Re-decide the template whenever the CONTRACT TYPE changes (golive #218).
+     *
+     * `mj-form-field` emits this from its value setter, so it fires for a person's edit and NOT for
+     * the programmatic assignment below — writing `Record.ContractTemplateID` directly bypasses the
+     * setter. That asymmetry is what keeps this from re-entering itself.
+     */
+    OnFieldValueChange(event: {
+        FieldName: string;
+    }): Promise<void>;
+    /**
+     * Put the current standard-terms version in the field, if we are allowed to.
+     *
+     * THE CHEAP HALF OF THE RULE RUNS FIRST. `RecordWantsDefaultTemplate` needs no database, and it
+     * is false for every saved contract — so opening an existing agreement costs no extra query at
+     * all, and the full rule is still evaluated in one place, on `ShouldDefaultTemplate`, before
+     * anything is written.
+     */
+    private defaultTemplate;
+    /**
+     * Does the contract's current type say its terms live in a template — `TemplateRequired`?
+     *
+     * READ FROM THE FLAG, NEVER FROM THE TYPE'S NAME. The columns on `ContractType` exist precisely
+     * so no code branches on a name someone can rename; `ContractEntityServer` reads the same flag
+     * to decide whether to REQUIRE the template this defaults.
+     *
+     * THREE-WAY, AND THE THIRD CASE IS LOAD-BEARING. `false` now means "this type does not want a
+     * template", which WITHDRAWS one this panel defaulted — so a read that failed must not be folded
+     * into it. It was `boolean` while defaulting was the only outcome, where swallowing a failure as
+     * `false` merely declined to act; under the withdrawal it would quietly take away a default on
+     * the strength of a query that never answered.
+     *
+     *   · `true`  — the type requires a template
+     *   · `false` — the type does not, or there is no type at all: both known answers
+     *   · `null`  — could not tell, and the caller does nothing in either direction
+     */
+    private typeRequiresTemplate;
+    /**
+     * The newest Published, usable template — the one a new contract should start on.
+     *
+     * A FAILED OR EMPTY READ IS SILENT, and deliberately so. This is a convenience: the field stays
+     * empty, the picker still works, and the server still refuses a save with no template when the
+     * type demands one — which is the message the user needs and the one they would already get.
+     * Announcing "could not default a template" on a form nobody has filled in yet reports our own
+     * plumbing as the user's problem.
+     */
+    private currentTemplateID;
     static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractAgreementPanel, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractAgreementPanel, "mjc-contract-agreement-panel", never, {}, {}, never, never, true, never>;
 }
@@ -69,30 +158,138 @@ export declare class MJCContractNotesPanel extends BaseFormPanel<ContractEntity>
     static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractNotesPanel, "mjc-contract-notes-panel", never, {}, {}, never, never, true, never>;
 }
 export declare class MJCContractProvenanceFieldsPanel extends BaseFormPanel<ContractEntity> {
+    private readonly cdr;
     /**
-     * READ-ONLY, and the section KEPT — a deliberate departure from issue #28 item 18.
+     * THE RAW IDS STAY, AND STAY READ-ONLY. The lookup above is what WRITES them (golive #219).
+     *
+     * ── WHY THEY WERE READ-ONLY, WHICH HAS NOT CHANGED ────────────────────────────────────────
      *
-     * Item 18 says to hide this section entirely, on the stated grounds that the hero's Source Deal
-     * link (item 1) replaces it. That premise does not hold yet. Item 1 renders the stat ONLY when
-     * `CreatingEntityID` and `CreatingRecordID` are both set, and on this database exactly one contract
-     * of eleven has them — `CTR-000026`, whose pair was typed in by hand: the entity is
-     * `MJ: Explorer Navigation Items` rather than Deals and the record id is not a valid UUID. So on
-     * every contract a person can currently open, the replacement is invisible. Hiding this section
-     * today would remove the only visible provenance for a stat that does not appear.
+     * `CreatingEntityID` is a real FK to `__mj.Entity` and `CreatingRecordID` is the row it names, under
+     * `CK_Contract_CreatingPairBothOrNeither` — both or neither. Rendered as two ordinary inputs
+     * (contracts#28 item 18) they produced exactly the two failures the shape invites: editing one
+     * alone is a save the constraint refuses, and editing both silently re-points a contract's
+     * provenance at an unrelated record. `CTR-000026` still carries the evidence — a hand-typed pair
+     * naming `MJ: Explorer Navigation Items` with a record id that is not a UUID.
      *
-     * WHAT ITEM 18 IS ACTUALLY ABOUT, and this half is not in doubt: these two fields rendered as
-     * ordinary inputs a person could type into, which is how that junk pair got there.
-     * `CreatingEntityID` is a real FK to `__mj.Entity` and `CreatingRecordID` is the row it names, and
-     * `CK_Contract_CreatingPairBothOrNeither` requires both or neither — so editing one field alone
-     * produces a save the constraint refuses, and editing both silently re-points a contract's
-     * provenance at an unrelated record, which is then what the hero's link displays. The server sets
-     * this pair (`LiveContractsSeam.setProvenance`, on Close-Won) and nothing else should.
+     * ── WHAT #219 ADDS, AND WHY IT IS NOT A REVERSAL ──────────────────────────────────────────
      *
-     * Read-only closes that defect and keeps the ids visible beneath the hero's human-readable name —
-     * complements rather than duplicates. Revisit hiding the section once a contract created by a real
-     * Close-Won deal exists to verify item 1 against.
+     * Story C-US1 says finance may attach a MANUALLY created contract to an existing deal. Item 18's
+     * read-only made that impossible: the Close Won seam became not just the preferred writer but the
+     * only one, and a contract typed in by hand could never show its deal. The answer is not to reopen
+     * the fields — it is to write them through a control that cannot produce a half pair. The lookup
+     * sets both halves from one chosen deal and clears both together; these two remain what they became
+     * in item 18, a read-only audit of what the pair actually holds, sitting under a human-readable name.
+     *
+     * The SECTION is likewise kept rather than hidden (item 18 asked for it gone, on the premise that
+     * the hero's Source Deal stat replaces it). With #219 that premise becomes true for deals — but the
+     * pair is polymorphic and the stat renders only what it can resolve, so the ids stay as the one
+     * place a reader can see the provenance verbatim, which is item 3 of #219.
      */
     readonly Fields: ContractFieldSpec[];
+    /** Options for the picker. Never read directly — go through the `Deals` getter, which loads. */
+    private _deals;
+    /** Bound to the combobox. Mirrors `CreatingRecordID`, and is '' whenever the source is not a deal. */
+    PickedDealID: string;
+    Loading: boolean;
+    /** Why the list is empty, when the reason is a failure rather than genuinely nothing. */
+    LoadError: string;
+    /** The pair names a record of some OTHER entity — surfaced rather than silently shown as blank. */
+    ForeignSource: boolean;
+    /** This contract arrived with provenance already recorded, so re-pointing takes a second click. */
+    Locked: boolean;
+    /** Label of the deal currently linked, for the locked line. */
+    SelectedLabel: string;
+    /**
+     * Which contract the picker was loaded for — not merely whether it was.
+     *
+     * The form reuses one component instance as it navigates, so a boolean leaves the PREVIOUS
+     * contract's candidates in the dropdown: a list scoped to the previous customer, which is a wrong
+     * list rather than a stale one. Same defect, same fix, as the Supersedes picker (contracts#28
+     * item 23).
+     */
+    private loadedFor;
+    private searchTimer;
+    /**
+     * Is there a Deals entity this user can see?
+     *
+     * Resolved from METADATA BY NAME, never imported: sales depends on contracts, so this app may not
+     * depend on sales (see `MJC_FOREIGN_ENTITIES.Deal`). A host without sales installed, or a user
+     * without read permission, simply gets no picker — the read-only ids and the hint below say so
+     * rather than rendering a control that can find nothing.
+     */
+    get DealLookupAvailable(): boolean;
+    /**
+     * Whether to render the lookup — AND the panel's single load trigger.
+     *
+     * `BaseFormPanel` has no lifecycle hook and the slot host sets `Record` before view init, so the
+     * first template read is the earliest reliable moment to do per-record work. This is the FIRST
+     * thing the template reads, which is the whole reason the trigger lives here rather than on
+     * `Deals`: the options are read inside the unlocked branch only, so a contract that arrives with
+     * provenance would never read them, `syncFromRecord()` would never run, and `Locked` would never
+     * become true — the guard silently absent on exactly the records it exists to protect.
+     *
+     * Keyed on the record so navigating the form to another contract re-syncs and reloads.
+     */
+    get ShowLookup(): boolean;
+    /** The candidate deals. Loaded by {@link ShowLookup}; this is a plain read. */
+    get Deals(): DealChoice[];
+    /**
+     * What the locked line says about the existing link.
+     *
+     * Deliberately does NOT claim the Close Won automation set it: nothing on the row records who
+     * did, and a contract linked by hand, saved and reopened arrives locked the same way. The panel
+     * says what it can actually see — the deal's name when the list has it, that the source is not a
+     * deal when the entity half says so, and otherwise nothing more than that something is linked.
+     * The raw ids sit directly below either way.
+     */
+    get LockedSummary(): string;
+    /** Release the re-point guard. Deliberate, and only ever by a click. */
+    Unlock(): void;
+    /**
+     * Take a chosen deal — and write BOTH halves of the pair, always.
+     *
+     * This is the whole reason the control exists. There is no path here that sets one column: a
+     * chosen deal writes the Deals entity id together with the deal's own id, and an empty selection
+     * goes through {@link ClearSource}, which empties both. The database's both-or-neither constraint
+     * (and the validator CodeGen derives from it) can therefore never be the thing that reports a
+     * mistake this form allowed a person to make.
+     */
+    PickDeal(dealID: string | null | undefined): void;
+    /** Empty BOTH halves. The constraint's other legal state, and #219's third acceptance criterion. */
+    ClearSource(): void;
+    /**
+     * Re-query as the user types, debounced.
+     *
+     * SERVER-SIDE, with the combobox's own `Filterable` off. Client filtering would need every deal in
+     * the database loaded to be correct, and it filters on the option LABEL — so a search that matched
+     * a customer whose name the label abbreviates would hide rows the server just returned. One
+     * authority for what matches, and it is the query.
+     */
+    Search(text: string): void;
+    /** The Deals entity's id, or null when this installation has no such entity. */
+    private dealEntityID;
+    /**
+     * Read the record's pair into the control's own state.
+     *
+     * The pair is POLYMORPHIC, so "there is a `CreatingRecordID`" does not mean "a deal is selected".
+     * Pre-selecting on the record id alone would show an unrelated record's id as the chosen deal; the
+     * entity half has to agree first, and when it does not, `ForeignSource` says so out loud.
+     *
+     * `Locked` is captured HERE — from what the record ARRIVED with — and never recomputed live. A
+     * live "already set, so lock it" would re-lock the instant a user picked a deal, which is the
+     * guard eating the very edit it was there to confirm.
+     */
+    private syncFromRecord;
+    /**
+     * Load the options.
+     *
+     * With nothing typed this is the contract's customer's deals — #219 item 2's "prefer deals for the
+     * contract's customer organization" — ORed with the deal already linked, so a contract pointed at
+     * a deal outside its customer still shows what it is pointed AT rather than a blank box. Typing
+     * widens the search to every deal by name, number or customer. The clauses themselves live in
+     * `@mj-biz-apps/contracts-entities`, where they can be unit-tested without Angular.
+     */
+    private load;
     static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractProvenanceFieldsPanel, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractProvenanceFieldsPanel, "mjc-contract-provenance-panel", never, {}, {}, never, never, true, never>;
 }

package/dist/lib/form-panels/contract-form.panels.d.ts.map

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