more

catalog/builder_test.go

@@ -194,7 +194,7 @@ func TestBuilderFractionalStringPriceCorrectScale(t *testing.T) {
 	}
 }
 
-// Drop-ship routing carriers (docs/plan-dropship.md Phase 1): seller id /
+// Drop-ship routing carriers (docs/archive/plan-dropship.md Phase 1): seller id /
 // name / lead time coerce from per-tenant source keys via Schema overrides,
 // mirroring how the live feed emits supplierName-style keys. Zero values
 // (missing keys, negative numbers, junk strings) must stay at the documented

catalog/doc.go

@@ -34,8 +34,9 @@
 //     issues a "lookup this SKU" RPC today and resolving it here would be
 //     premature.
 //
-// See docs/published-document-vocabulary-pass.md §11 for the wider vocabulary
-// context (this package implements the cart side of that contract; the full
-// vocabulary is the next pass and lives in `platform/published` once proven
-// out).
+// This package implements the catalog side of the shared vocabulary used by
+// `platform/event` + `platform/inventory` + `platform/order`. A generic
+// `platform/node` aggregate is deliberately held back (see docs/status.md
+// "Deliberately deferred"); cross-module boundaries are served by
+// `platform/catalog` + `platform/projection` instead.
 package catalog

catalog/projection.go

@@ -106,7 +106,7 @@ type Projection struct {
 	TaxClass         string          `json:"tax_class"`
 	InventoryTracked bool            `json:"inventory_tracked"`
 	DropShip         bool            `json:"drop_ship"`
-	// Drop-ship routing carriers (Phase 1 of docs/plan-dropship.md).
+	// Drop-ship routing carriers (Phase 1 of docs/archive/plan-dropship.md).
 	// SellerID mirrors AddItem.ItemId coercion rules: 0 = "producer didn't
 	// publish" and downstream keeps whatever the HTTP fallback fetched.
 	// SellerName is what checkout writes into order-line