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,59 @@
# Supply Chain Entity Schema v1.0
Every extracted entity must contain the following sections in this order.
## Required Sections
### H1 Heading
The entity name in title case. Should be a noun phrase identifying a
distinct concept, mechanism, or structure in supply chain management.
Example: `# Bullwhip Effect`
### Definition
20150 words. Precise, non-circular definition of the concept. Must
identify what it is, not just what it does. Avoid defining a term
using the term itself.
### Source
The source document this entity was extracted from, citing section
if available. Format: `[Source Name], [Section]`
### Supply Chain Domain
One of: **Coordination**, **Capital Management**, **Market Structure**,
**Risk**, **Logistics**
### VSM Assignment
One of: S1, S2, S3, S3*, S4, S5 — which layer of the Viable System Model
this entity primarily inhabits. Brief rationale (one sentence).
### WoN Concept
The Wealth of Nations concept this entity most directly corresponds to.
State the WoN entity name and a one-sentence explanation of the connection.
If no direct correspondence exists, state "No direct WoN analogue" and
explain why.
## Optional Sections
### Modern Context
Additional notes on how the concept has evolved since Smith's time, or
how it differs from its classical form.
## Quality Metrics
Evaluation rubric for per-entity LLM assessment:
- **Definition Precision** (15): Is the definition specific, non-circular,
and distinguishable from adjacent concepts?
- **Source Grounding** (15): Is the entity grounded in the source material?
- **Domain Placement** (15): Is the supply chain domain assignment correct?
- **WoN Relevance** (15): Is the WoN mapping substantive and well-reasoned?
- **Explanatory Value** (15): Does this entity contribute to understanding
modern supply chains through the WoN lens?