feat(example): add supply-chain-vsm composition demo (S3.5)

Demonstrates infospace composition: the Wealth of Nations infospace is
used as a discipline, applying Smith's economic framework as a lens to
analyse modern supply chain management concepts.

New example: examples/supply-chain-vsm/
- infospace.yaml binding WoN as discipline (../infospace-with-history)
- 3 source documents: coordination mechanisms, capital & inventory,
  market structure (~400 words each, original content)
- supply-chain-entity-schema-v1.0.md with WoN Concept required section
- won-mapping-schema-v1.0.md with Conceptual Continuity rating
- artifacts/won-reference/core-entities.md — 12 curated WoN entities
  for injection as discipline context
- 8 hand-crafted entity files demonstrating LLM output format
- 3 mapping files with full rationale and VSM inheritance chains
- Viable: YES (5/5 thresholds)

Key mappings demonstrated:
  Demand Signal          → Effectual Demand        (Strong, S2)
  Vendor-Managed Inventory → Division of Labour    (Strong, S1/S2)
  Just-in-Time Inventory → Circulating Capital     (Strong, S1/S3)
  Bullwhip Effect        → Natural Price           (Moderate, S2)
  Platform Intermediary  → Merchant Capital        (Strong, S2/S4)
  Monopsony Power        → Combination of Masters  (Strong, S3*)

Platform fix: entity_parser.py now recognises ## Supply Chain Domain
as a domain alias for ## Economic Domain, enabling composed infospaces
to use their own domain section name.

Tutorial §13 rewritten with real commands, real output, and the full
mapping table from the demo.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-23 00:08:51 +01:00
parent 8f00fa2018
commit 574bb11db6
27 changed files with 1696 additions and 15 deletions

View File

@@ -0,0 +1,63 @@
# Coordination Mechanisms in Modern Supply Chains
## Demand Signals and Information Flow
Supply chains coordinate through the propagation of demand signals upstream
from end consumers through retailers, distributors, and manufacturers to raw
material suppliers. The quality and latency of these signals determine how
well production is synchronised with actual consumption.
In a well-functioning supply chain, a retailer's point-of-sale data becomes
the input signal for a distributor's replenishment order, which in turn
signals the manufacturer to schedule production runs. When this chain
operates with full transparency and zero delay, production closely tracks
consumption. When it operates with delays, batching, or information
filtering, coordination failures emerge.
## The Bullwhip Effect
The bullwhip effect describes the amplification of demand variability as
signals travel upstream in a supply chain. A 5% fluctuation in retail
demand may translate into a 20% fluctuation in distributor orders and a
40% swing in manufacturer production schedules. This amplification occurs
because each node in the chain adds a safety buffer to its orders, reacts
to the previous period's signal rather than real-time data, and places
orders in discrete batches rather than continuously.
The result is a supply chain that oscillates — periods of excess inventory
alternating with periods of shortage — even when underlying consumer demand
is relatively stable. The bullwhip effect is not a market equilibrium; it
is a coordination failure in which the absence of shared real-time
information causes each rational local decision to produce irrational
aggregate outcomes.
## Vendor-Managed Inventory
Vendor-managed inventory (VMI) is a coordination arrangement in which the
supplier, rather than the buyer, is responsible for maintaining stock levels
at the buyer's location. The supplier has read access to the buyer's
inventory data and automatically replenishes when stock falls below a
specified threshold. Payment occurs when the buyer consumes the goods, not
when they arrive.
VMI represents a reallocation of the inventory management function: the
buyer surrenders operational control over a specific task (replenishment)
to the party better positioned to perform it (the supplier, who controls
the supply side). This specialisation of function reduces transaction costs,
improves forecast accuracy (the supplier sees real consumption, not
batch orders), and smooths the demand signal upstream.
## Supply Chain Visibility
Supply chain visibility refers to the degree to which all participants can
observe the state of inventory, orders, and shipments across the entire
chain in real time. High visibility reduces the information asymmetries
that drive the bullwhip effect and enables coordinated responses to
disruption.
Modern visibility platforms aggregate data from tracking systems, IoT
sensors, and partner APIs to provide a unified operational picture. The
commercial value of visibility comes from reducing the cost of safety
stock (since uncertainty is lower) and enabling faster responses to supply
shocks. Visibility is not merely a technical feature; it is a coordination
mechanism that changes the incentive structure for every node in the chain.