@snolla/data 0.0.0-stage → 1.0.7

package/dist/scripts/owners/owner-resolve-spec.json

@@ -0,0 +1,540 @@
+{
+    "spec": "owner-name-resolution",
+    "version": 1,
+    "task": "task:3818",
+    "title": "OwnerName -> (table, pk): контракт резолва полиморфных владельцев легаси-MSSQL",
+    "evidence": {
+        "snapshot": "owners-observed.json",
+        "probe": "probe-owner-names.mjs",
+        "source": "read-only probe of production MSSQL (mssql.kzntsv.site / MoreThenCms), 2026-10-13",
+        "canon": "packages/data/schema (task:3812) — the spec may only point at canon tables"
+    },
+    "observedTotals": {
+        "Gallery": 5430,
+        "orphans": 638,
+        "idOwnerNull": 0
+    },
+    "resolutionOrder": [
+        "IdOwner (GUID) -> owner table row; OwnerName is only a cross-check",
+        "OwnerName is NOT authoritative: legacy code writes role names, the API writes 'owner' (GalleriesController.cs:51), and the data carries values no legacy class implements (Theme, PostModule, postPart)"
+    ],
+    "observedOwners": {
+        "Product": {
+            "table": "Products",
+            "pk": "ProductId",
+            "rows": 2719,
+            "orphans": 128,
+            "status": "resolvable"
+        },
+        "Post": {
+            "table": "Posts",
+            "pk": "PostId",
+            "rows": 1141,
+            "orphans": 10,
+            "status": "resolvable"
+        },
+        "Theme": {
+            "table": "Themes",
+            "pk": "ThemeId",
+            "rows": 590,
+            "orphans": 335,
+            "status": "resolvable"
+        },
+        "Page": {
+            "table": "Pages",
+            "pk": "PageId",
+            "rows": 521,
+            "orphans": 9,
+            "status": "resolvable"
+        },
+        "PostModule": {
+            "table": "Modules",
+            "pk": "ModuleId",
+            "rows": 156,
+            "orphans": 0,
+            "status": "resolvable"
+        },
+        "postPart": {
+            "table": "Parts",
+            "pk": "PartId",
+            "rows": 136,
+            "orphans": 136,
+            "status": "quarantine-only",
+            "reason": "Parts is dropped from the canon (task:3812 DROPPED list) and holds 0 rows in production -> every postPart gallery is an orphan by construction"
+        },
+        "CatalogProduct": {
+            "table": "CatalogProducts",
+            "pk": "ProductId",
+            "rows": 127,
+            "orphans": 4,
+            "status": "resolvable"
+        },
+        "tableRecord": {
+            "table": "TableRecords",
+            "pk": "RecordId",
+            "rows": 34,
+            "orphans": 16,
+            "status": "resolvable"
+        },
+        "Store": {
+            "table": "Stores",
+            "pk": "StoreId",
+            "rows": 2,
+            "orphans": 0,
+            "status": "resolvable"
+        },
+        "catalog": {
+            "table": "Catalogs",
+            "pk": "CatalogId",
+            "rows": 2,
+            "orphans": 0,
+            "status": "resolvable"
+        },
+        "blog": {
+            "table": "Blogs",
+            "pk": "BlogId",
+            "rows": 1,
+            "orphans": 0,
+            "status": "resolvable"
+        },
+        "link": {
+            "table": "Links",
+            "pk": "LinkId",
+            "rows": 1,
+            "orphans": 0,
+            "status": "resolvable"
+        }
+    },
+    "aliases": {
+        "TableRecord": {
+            "aliasOf": "tableRecord"
+        },
+        "Part": {
+            "aliasOf": "postPart"
+        },
+        "Module": {
+            "aliasOf": "PostModule"
+        },
+        "Catalog": {
+            "aliasOf": "catalog"
+        },
+        "Blog": {
+            "aliasOf": "blog"
+        },
+        "Link": {
+            "aliasOf": "link"
+        },
+        "CatalogProducts": {
+            "aliasOf": "CatalogProduct"
+        },
+        "ProductVariant": {
+            "table": "ProductVariants",
+            "pk": "VariantId"
+        },
+        "CatalogCategory": {
+            "table": "CatalogCategories",
+            "pk": "CategoryId"
+        },
+        "CatalogTag": {
+            "table": "CatalogTags",
+            "pk": "TagId"
+        },
+        "BlogCategory": {
+            "table": "BlogCategories",
+            "pk": "CategoryId"
+        },
+        "BlogTag": {
+            "table": "BlogTags",
+            "pk": "TagId"
+        },
+        "BlogAuthor": {
+            "table": "BlogAuthors",
+            "pk": "AuthorId"
+        },
+        "CustomCategory": {
+            "table": "CustomCategories",
+            "pk": "CategoryId"
+        },
+        "customCategory": {
+            "table": "CustomCategories",
+            "pk": "CategoryId"
+        },
+        "StoreCategory": {
+            "table": "StoreCategories",
+            "pk": "CategoryId"
+        },
+        "StoreTag": {
+            "table": "StoreTags",
+            "pk": "TagId"
+        },
+        "StoreVendor": {
+            "table": "StoreVendors",
+            "pk": "VendorId"
+        },
+        "Watermark": {
+            "table": "Watermark_ImageWatermark",
+            "pk": "IdWatermark"
+        },
+        "watermark": {
+            "table": "Watermark_ImageWatermark",
+            "pk": "IdWatermark"
+        },
+        "ImageWatermark": {
+            "table": "Watermark_ImageWatermark",
+            "pk": "IdWatermark"
+        }
+    },
+    "polyRoots": {
+        "Folders": {
+            "ownerColumn": "OwnerId",
+            "nameColumn": null,
+            "siteFrom": "owner-row",
+            "unresolved": "refuse",
+            "note": "Legacy `AssetsFolder.OwnerId` is `IAssetsOwner.AssetsOwnerId` (MoreThenCms/Assets/AssetsFolder.cs, IAssetsOwner.cs) and the folder's public path is /assets/<ownerId:N>/, so the owner set is exactly the interface's implementors: Page, Post, Product, Store/StoreCategory/StoreTag/StoreVendor, Catalog/CatalogCategory/CatalogTag/CatalogProduct, TableRecord, Form and the site itself (ISiteContext.AssetsOwnerId == SiteId). Parts are NOT in this set — `BasePart` implements IGalleryOwner (galleries), not IAssetsOwner (task:3976).",
+            "evidence": {
+                "totalFolders": 183639,
+                "assetsFolders": 182871,
+                "themeFolders": 768,
+                "distinctOwners": 182844,
+                "ownersResolved": 16265,
+                "ownersDangling": 166579,
+                "foldersWithFiles": 163,
+                "source": "MoreThenCms_m1 / production MoreThenCms, 2026-10-19"
+            },
+            "resolvers": [
+                {
+                    "column": "OwnerId",
+                    "table": "Pages",
+                    "pk": "PageId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Posts",
+                    "pk": "PostId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Products",
+                    "pk": "ProductId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "CatalogProducts",
+                    "pk": "ProductId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Catalogs",
+                    "pk": "CatalogId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "CatalogCategories",
+                    "pk": "CategoryId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "CatalogTags",
+                    "pk": "TagId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Stores",
+                    "pk": "StoreId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "StoreCategories",
+                    "pk": "CategoryId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "StoreTags",
+                    "pk": "TagId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "StoreVendors",
+                    "pk": "VendorId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "TableRecords",
+                    "pk": "RecordId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Forms",
+                    "pk": "FormId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Sites",
+                    "pk": "SiteId"
+                }
+            ],
+            "danglingAllowed": {
+                "columns": [
+                    "ImagesFolder_ThemeId",
+                    "ScriptsFolder_ThemeId",
+                    "StylesheetsFolder_ThemeId"
+                ],
+                "reason": "theme folders (768 on MoreThenCms_p1) carry no owner at all: the site comes from the canon FK to Themes, not from OwnerId (task:3976)"
+            }
+        },
+        "Gallery": {
+            "ownerColumn": "IdOwner",
+            "nameColumn": "OwnerName",
+            "nameRole": "cross-check only; never the join key",
+            "targets": "observedOwners + aliases",
+            "siteFrom": "owner-row",
+            "unresolved": "refuse",
+            "evidence": {
+                "total": 5430,
+                "orphans": 638,
+                "idOwnerNull": 0
+            },
+            "resolvers": [
+                {
+                    "column": "IdOwner",
+                    "table": "Products",
+                    "pk": "ProductId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Posts",
+                    "pk": "PostId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Themes",
+                    "pk": "ThemeId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Pages",
+                    "pk": "PageId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Modules",
+                    "pk": "ModuleId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "CatalogProducts",
+                    "pk": "ProductId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "TableRecords",
+                    "pk": "RecordId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Stores",
+                    "pk": "StoreId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Catalogs",
+                    "pk": "CatalogId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Blogs",
+                    "pk": "BlogId"
+                },
+                {
+                    "column": "IdOwner",
+                    "table": "Links",
+                    "pk": "LinkId"
+                }
+            ]
+        },
+        "Modules": {
+            "hostColumns": [
+                "PostId",
+                "PageId"
+            ],
+            "hostTables": {
+                "PostId": "Posts",
+                "PageId": "Pages"
+            },
+            "nameColumn": null,
+            "siteFrom": "owner-row",
+            "resolvers": [
+                {
+                    "column": "PostId",
+                    "table": "Posts",
+                    "pk": "PostId"
+                },
+                {
+                    "column": "PageId",
+                    "table": "Pages",
+                    "pk": "PageId"
+                }
+            ],
+            "unresolved": "refuse",
+            "evidence": {
+                "total": 165,
+                "discriminator": {
+                    "PostModule": 165
+                },
+                "postIdSet": 165,
+                "pageIdSet": 0,
+                "orphans": 0,
+                "note": "live Modules has no OwnerName column: the host is the non-null PostId/PageId FK, not a name"
+            }
+        },
+        "GalleryImagesTemplates": {
+            "siteFrom": "none",
+            "nameColumn": null,
+            "note": "task:3891 — a dictionary of image templates keyed by OwnerTemplateId with no single owner column, and empty in production (owners-observed.json emptyMaps: 0 rows). It therefore carries no site of its own: its rows, if any ever appear, are the sweep's business. Without this declaration the plan would report it unresolved and refuse a cutover over an empty map."
+        },
+        "GalleryImageSizeWatermark": {
+            "siteFrom": "parent-chain",
+            "resolvers": [
+                {
+                    "column": "GalleryImageSize_IdSize",
+                    "table": "GalleryImageSize",
+                    "pk": "IdSize"
+                },
+                {
+                    "column": "Watermark_IdWatermark",
+                    "table": "Watermark",
+                    "pk": "IdWatermark"
+                }
+            ],
+            "note": "task:3876 — a watermark configuration hangs off a gallery image size and off the watermark itself. Both legs are chained from the Gallery root, so this root's own step must wait until those parents carry a site (the planner reads that dependency off `resolvers`; the second leg is the fallback for rows the first does not reach)."
+        },
+        "NumberingCounters": {
+            "siteFrom": "owner-row",
+            "resolvers": [
+                {
+                    "column": "OwnerId",
+                    "table": "Blogs",
+                    "pk": "BlogId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Stores",
+                    "pk": "StoreId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Catalogs",
+                    "pk": "CatalogId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Sites",
+                    "pk": "SiteId"
+                }
+            ],
+            "note": "OwnerId is a soft reference (Blog / Store / Catalog / Site), resolved by GUID; the name column is absent. Declared here rather than in the planner since task:3876, so every root follows one rule."
+        },
+        "_Modules": {
+            "ownerColumn": "OwnerId",
+            "nameColumn": null,
+            "siteFrom": "owner-row",
+            "unresolved": "refuse",
+            "note": "task:3895 — `_Modules` is the legacy twin of `Modules` (its rows are the module instances the templates describe) and its `OwnerId` is the same polymorphic owner reference. It leaned on the implicit `observedOwners` fallback: a spec edit could have reordered the probe with nothing to notice. Declared here in the same order the fallback used (production: 18 rows, none of them matches an owner — real orphans, they stay on the sentinel).",
+            "resolvers": [
+                {
+                    "column": "OwnerId",
+                    "table": "Products",
+                    "pk": "ProductId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Posts",
+                    "pk": "PostId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Themes",
+                    "pk": "ThemeId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Pages",
+                    "pk": "PageId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Modules",
+                    "pk": "ModuleId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "CatalogProducts",
+                    "pk": "ProductId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "TableRecords",
+                    "pk": "RecordId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Stores",
+                    "pk": "StoreId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Catalogs",
+                    "pk": "CatalogId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Blogs",
+                    "pk": "BlogId"
+                },
+                {
+                    "column": "OwnerId",
+                    "table": "Links",
+                    "pk": "LinkId"
+                }
+            ]
+        }
+    },
+    "unresolved": {
+        "policy": "refuse",
+        "exit": "--purge --manifest <dir>",
+        "reason": "task:4092 — nothing is parked. A row that ends the run without a site is a missing edge in the resolver graph, not data to file away: the cutover SQL refuses by table name, and deleting the leftovers is an explicit operator decision (children first, primary keys written to a manifest before the first delete). The sentinel site is gone from the migration — planting it made 169 175 lost rows look placed while the run reported green, and it hid the real defect (tables that already carried SiteId were never backfilled).",
+        "cascadeRows": {
+            "Gallery": 638,
+            "GalleryImage": 297,
+            "GalleryImageFile": 295,
+            "GalleryImageSize": 1048,
+            "GalleryImageSizeWatermark": 17,
+            "Watermark": 14
+        },
+        "janitor": "polymorphic OwnerId cannot carry a FK -> orphans will re-accumulate; a janitor task / delete hook is a known debt",
+        "cascadeRowsDefinition": "child rows attached to the quarantined galleries (row counts, not distinct galleries)"
+    },
+    "numbering": {
+        "tasks": {
+            "seed": 4,
+            "labels": [
+                "PostNumber",
+                "CatalogProductNumber",
+                "StoreProductNumber",
+                "FormSubmission"
+            ],
+            "rule": "NumberingTasks is global config: 4 default rows for the whole database, NOT 4 per site. Superseded the earlier 'seed per site' rule (task:3876, operator verdict): the live table never carried SiteId, callers address a task by GUID and NumberingCounters.TaskId is a hard FK to it, so per-site copies would mean new ids plus a rewrite of every counter and every stored id — for rows that are identical across the database. Canon scope: dictionary."
+        },
+        "counters": {
+            "rows": 86,
+            "distinctOwners": 85,
+            "siteFrom": "resolved owner row (Blog / Store / Catalog / Site) -> owner.SiteId; unresolvable -> quarantine",
+            "rule": "OwnerId is a soft reference like Gallery.IdOwner; resolve by GUID, name column is absent"
+        }
+    },
+    "anomalies": [
+        "OwnerName = 'owner' is written by the legacy API (GalleriesController.cs:51) and names no type — resolvable only via IdOwner",
+        "lowercase aliases (catalog / blog / link / postPart / tableRecord) are real production values, not typos to normalize away",
+        "deviation from wiki:3821: Modules resolves through PostId/PageId FKs, not OwnerName/OwnerId (verified live: no OwnerName column)"
+    ]
+}

package/dist/scripts/owners-audit.d.mts

@@ -0,0 +1,60 @@
+/**
+ * Run every contract check against one adapter. Returns the report (the same
+ * shape the production dry-run produced) and the discrepancy list.
+ */
+export function runOwnerAudit({ adapter, contract, log }: {
+    adapter: any;
+    contract?: {
+        spec: any;
+        observed: any;
+        ownership: any;
+    };
+    log?: () => void;
+}): Promise<{
+    report: {
+        _task: string;
+        _source: any;
+        _target: any;
+        clusters: {};
+    };
+    discrepancies: string[];
+}>;
+export const REPO_CONTRACT: {
+    spec: any;
+    observed: any;
+    ownership: any;
+};
+export const PROD_EVIDENCE: string;
+export function sqliteAdapter(db: any, { source, target }?: {
+    source?: string;
+    target?: string;
+}): {
+    source: string;
+    target: string;
+    quote: (name: any) => string;
+    query: (sql: any) => Promise<any>;
+    tableColumns: (tables: any) => Promise<Map<any, any>>;
+    tablesWithColumn: (column: any) => Promise<Set<any>>;
+    close: () => Promise<void>;
+};
+export function parseMssqlUrl(url: any): {
+    server: string;
+    port: number;
+    database: any;
+    user: any;
+    password: any;
+    encrypt: boolean;
+    trustServerCertificate: boolean;
+};
+export function mssqlAdapter({ url, source, target }?: {
+    source?: string;
+}): Promise<{
+    source: string;
+    target: any;
+    quote: (name: any) => string;
+    query: (sql: any) => Promise<any>;
+    tableColumns: (tables: any) => Promise<Map<any, any>>;
+    tablesWithColumn: (column: any) => Promise<Set<any>>;
+    close: () => Promise<any>;
+}>;
+export function reportDiff(fresh: any, expected: any): any[];