feat(infospace): add L3 relation graph with VSM-aware triplets (S2.8)

Implements the L3 relation graph layer — a directed graph of (Subject,
Predicate, Object) triplets annotated with VSM channel codes and feedback
roles. Triplets are authored as markdown files under output/relations/,
parsed into RelationMeta dataclasses, and analysed with networkx.

New modules:
- markitect/infospace/relation_models.py — RelationMeta dataclass +
  RELATION_TYPES controlled vocabulary (15 relation classes → VSM codes)
- markitect/infospace/relation_parser.py — parse_relation_file() and
  parse_relations_directory()

New schema: examples/infospace-with-history/schemas/relation-schema-v1.0.md
  — file naming convention, required sections, controlled vocabulary table

15 seed relation files covering the three core WoN feedback loops:
  - Capital Accumulation loop (positive reinforcement, S1/S3)
  - Market Price Balancing loop (negative feedback, S2/S3)
  - Market Extent mutual dependency (S1/S2)
  Plus structural relations: wages regulation, rent residual, price
  decomposition, invisible hand coordination

CLI: markitect infospace relations [--entity SLUG] [--vsm FILTER]
     [--loops] [--stats]
  - Builds directed graph from parsed files
  - Detects feedback loops via nx.simple_cycles()
  - 6 loops found from 15 seed relations (3 intended + 3 emergent)
  - --stats aggregates by VSM system code (strips parentheticals)

Config: InfospaceConfig gains relations_dir (default output/relations)
infospace.yaml: schemas.relation references relation-schema-v1.0.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

examples/infospace-with-history/infospace.yaml

@@ -17,6 +17,7 @@ schemas:
   entity: schemas/economic-entity-schema-v1.0.md
   mapping: schemas/vsm-mapping-schema-v1.0.md
   analysis: schemas/chapter-analysis-schema-v1.0.md
+  relation: schemas/relation-schema-v1.0.md
 
 competency_questions: |
   1. How does Smith's division of labour map to VSM System 1 operations?

examples/infospace-with-history/output/relations/accumulation_of_stock--enables--division_of_labour.md

@@ -0,0 +1,38 @@
+# Accumulation of Stock — enables — Division of Labour
+
+## Subject
+
+Accumulation of Stock
+
+## Predicate
+
+enables
+
+## Object
+
+Division of Labour
+
+## Relation Type
+
+enables
+
+## VSM Channel
+
+S3 → S1 (capital stock managed at S3 deploys productive capacity at S1)
+
+## Evidence
+
+Book I, Chapter 6: "As soon as stock has accumulated in the hands of
+particular persons, some of them will naturally employ it in setting to work
+industrious people, whom they will supply with materials and subsistence."
+
+## Feedback Role
+
+**Capital Accumulation loop (positive/reinforcing):**
+Accumulation of Stock → enables → Division of Labour → increases →
+Productive Powers of Labour → raises → Profits of Stock → funds →
+Accumulation of Stock.
+
+This edge (enables) is the initiating link: accumulated capital is the
+prerequisite for organising specialised production. Without prior accumulation
+there is no employer to assign and coordinate different tasks.

examples/infospace-with-history/output/relations/accumulation_of_stock--increases--market_price_of_commodities.md

@@ -0,0 +1,42 @@
+# Accumulation of Stock — increases supply that depresses — Market Price of Commodities
+
+## Subject
+
+Accumulation of Stock
+
+## Predicate
+
+increases supply, depressing
+
+## Object
+
+Market Price of Commodities
+
+## Relation Type
+
+regulates
+
+## VSM Channel
+
+S3 → S2 (capital deployment increases supply, correcting price signal)
+
+## Evidence
+
+Book I, Chapter 7: "When the quantity brought to market exceeds the
+effectual demand, it cannot be all sold to those who are willing to pay
+the whole value of the rent, wages and profit, which must be paid in
+order to bring it thither. Some part must be sold to those who are
+willing to pay less, and the low price which they give for it must
+reduce the price of the whole."
+
+## Feedback Role
+
+**Market Price Balancing loop (negative/balancing):**
+Market Price above Natural Price → attracts → Capital inflow →
+increases supply → depresses → Market Price back toward Natural Price.
+
+This edge (increases supply, depressing) closes the balancing loop:
+directed capital raises output until oversupply brings price back down.
+This is the mechanism behind Smith's claim that natural price acts as
+the "central price, to which the prices of all commodities are
+continually gravitating."

examples/infospace-with-history/output/relations/division_of_labour--constrains--market_extent.md

@@ -0,0 +1,40 @@
+# Division of Labour — constrains — Market Extent
+
+## Subject
+
+Division of Labour
+
+## Predicate
+
+limited by
+
+## Object
+
+Market Extent
+
+## Relation Type
+
+constrains
+
+## VSM Channel
+
+S2 ← S1 (the coordination reach of markets bounds the scope of operational specialisation)
+
+## Evidence
+
+Book I, Chapter 3: "As it is the power of exchanging that gives occasion
+to the division of labour, so the extent of this division must always be
+limited by the extent of that power, or, in other words, by the extent
+of the market."
+
+## Feedback Role
+
+**Market Expansion loop (positive/reinforcing):**
+Market Extent → enables greater Division of Labour → raises Productive
+Powers of Labour → generates surplus → expands Trade → expands
+Market Extent.
+
+This edge (limited by) is the structural constraint that gives the loop
+its character: the level of specialisation that can be sustained depends
+on the size of the market that can absorb the specialised output.
+Smith's famous opening of Chapter III states this with unusual directness.

examples/infospace-with-history/output/relations/division_of_labour--increases--productive_powers_of_labour.md

@@ -0,0 +1,40 @@
+# Division of Labour — increases — Productive Powers of Labour
+
+## Subject
+
+Division of Labour
+
+## Predicate
+
+increases
+
+## Object
+
+Productive Powers of Labour
+
+## Relation Type
+
+enables
+
+## VSM Channel
+
+S1 → S1 (operational specialisation raises operational output per unit)
+
+## Evidence
+
+Book I, Chapter 1: "The greatest improvement in the productive powers of
+labour, and the greater part of the skill, dexterity, and judgment with
+which it is anywhere directed, or applied, seem to have been the effects
+of the division of labour."
+
+## Feedback Role
+
+**Capital Accumulation loop (positive/reinforcing):**
+Accumulation of Stock → enables → Division of Labour → increases →
+Productive Powers of Labour → raises → Profits of Stock → funds →
+Accumulation of Stock.
+
+This edge (increases) is the productivity mechanism: specialisation
+improves dexterity, saves time between tasks, and facilitates the
+invention of machinery — three distinct channels that all raise output
+per worker.

examples/infospace-with-history/output/relations/invisible_hand_mechanism--coordinates--accumulation_of_stock.md

@@ -0,0 +1,40 @@
+# Invisible Hand Mechanism — coordinates — Accumulation of Stock
+
+## Subject
+
+Invisible Hand Mechanism
+
+## Predicate
+
+coordinates (directs capital allocation without central direction)
+
+## Object
+
+Accumulation of Stock
+
+## Relation Type
+
+coordinates
+
+## VSM Channel
+
+S4 → S3 (distributed environmental intelligence shapes capital allocation decisions)
+
+## Evidence
+
+Book IV, Chapter 2: "He generally, indeed, neither intends to promote the
+public interest, nor knows how much he is promoting it... he intends only
+his own security; and by directing that industry in a manner whose produce
+may be of the greatest value, he intends only his own gain, and he is in
+this, as in many other cases, led by an invisible hand to promote an end
+which was no part of his intention."
+
+## Feedback Role
+
+The Invisible Hand Mechanism is the S4 intelligence function that makes
+the Market Price Balancing loop self-organising. Individual capitalists
+seeking private profit collectively direct accumulation to where returns
+are highest, which (through the market price balancing loop) also serves
+as a resource allocation mechanism. This relation explains why the system
+does not require a planner — the S4 function is distributed across all
+capital owners simultaneously.

examples/infospace-with-history/output/relations/market_extent--enables--division_of_labour.md

@@ -0,0 +1,40 @@
+# Market Extent — enables — Division of Labour
+
+## Subject
+
+Market Extent
+
+## Predicate
+
+enables (by providing demand for specialised output)
+
+## Object
+
+Division of Labour
+
+## Relation Type
+
+enables
+
+## VSM Channel
+
+S2 → S1 (coordination reach of markets enables operational specialisation)
+
+## Evidence
+
+Book I, Chapter 3: "When the market is very small, no person can have
+any encouragement to dedicate himself entirely to one employment, for
+want of the power to exchange all that surplus part of the produce of his
+own labour, which is over and above his own consumption, for such parts
+of the produce of other men's labour as he has occasion for."
+
+## Feedback Role
+
+**Market Expansion loop (positive/reinforcing):**
+Market Extent → enables → Division of Labour → raises Productive Powers
+of Labour → generates surplus → expands Trade → expands Market Extent.
+
+Together with the constrains edge (Division of Labour ← Market Extent),
+this pair forms the mutual dependency at the heart of Book I: markets
+enable specialisation, and specialisation generates the surplus that
+expands markets.

examples/infospace-with-history/output/relations/market_price_of_commodities--attracts--accumulation_of_stock.md

@@ -0,0 +1,41 @@
+# Market Price of Commodities — attracts — Accumulation of Stock
+
+## Subject
+
+Market Price of Commodities
+
+## Predicate
+
+attracts (when above natural price)
+
+## Object
+
+Accumulation of Stock
+
+## Relation Type
+
+coordinates
+
+## VSM Channel
+
+S2 → S3 (price signal coordinates capital reallocation)
+
+## Evidence
+
+Book I, Chapter 7: "When the quantity brought to market falls short of the
+effectual demand, all those who are willing to pay the whole natural price
+cannot be supplied. Some of them will be willing to give more. A competition
+will immediately begin among them, and the market price will rise more or
+less above the natural price."
+
+## Feedback Role
+
+**Market Price Balancing loop (negative/balancing):**
+Market Price above Natural Price → attracts → Capital inflow (Accumulation
+directed to this market) → increases Supply → depresses → Market Price
+back toward Natural Price.
+
+This edge (attracts) is the signal-response link: a market price above
+natural price is a profit opportunity that draws capital from other uses.
+Smith's key insight is that this signal is self-cancelling — it eliminates
+the very excess that created it.

examples/infospace-with-history/output/relations/market_price_of_commodities--decomposes_into--profits_of_stock.md

@@ -0,0 +1,37 @@
+# Market Price of Commodities — decomposes into — Profits of Stock
+
+## Subject
+
+Market Price of Commodities
+
+## Predicate
+
+decomposes into (profit as component)
+
+## Object
+
+Profits of Stock
+
+## Relation Type
+
+produces
+
+## VSM Channel
+
+S2 → S3 (price signal resolves into return on capital, which S3 manages)
+
+## Evidence
+
+Book I, Chapter 6: "In every society the price of every commodity
+finally resolves itself into some one or other, or all of those three
+parts; and in every improved society, all three enter more or less,
+as component parts, into the price of the far greater part of commodities."
+
+## Feedback Role
+
+Part of the **Three-Component Decomposition** (see also wages and rent
+relations). This edge links the market price coordination signal (S2)
+to the capital management outcome (S3), establishing profit as the
+mechanism by which market performance translates into the fund for
+future accumulation. It is the bridge between the Market Price Balancing
+loop and the Capital Accumulation loop.

examples/infospace-with-history/output/relations/market_price_of_commodities--decomposes_into--wages_of_labour.md

@@ -0,0 +1,38 @@
+# Market Price of Commodities — decomposes into — Wages of Labour
+
+## Subject
+
+Market Price of Commodities
+
+## Predicate
+
+decomposes into (wages as component)
+
+## Object
+
+Wages of Labour
+
+## Relation Type
+
+produces
+
+## VSM Channel
+
+S2 → S2 (price as coordination signal resolves into its component coordination signals)
+
+## Evidence
+
+Book I, Chapter 6: "In every society the price of every commodity
+finally resolves itself into some one or other, or all of those three
+parts [wages, profit, rent]; and in every improved society, all three
+enter more or less, as component parts, into the price of the far greater
+part of commodities."
+
+## Feedback Role
+
+This is one of the three price-decomposition relations (alongside market
+price → profits of stock, and market price → rent of land). Together
+they form the **Three-Component Decomposition**: the price system
+connects the coordination layer (S2) back to the distributional outcomes
+for all three factor markets. The decomposition is the analytical
+foundation from which Books I and II derive their structure.

examples/infospace-with-history/output/relations/natural_price_as_central_price--centres--market_price_of_commodities.md

@@ -0,0 +1,35 @@
+# Natural Price as Central Price — centres — Market Price of Commodities
+
+## Subject
+
+Natural Price as Central Price
+
+## Predicate
+
+centres
+
+## Object
+
+Market Price of Commodities
+
+## Relation Type
+
+coordinates
+
+## VSM Channel
+
+S2 (natural price is the attractor in the S2 coordination field)
+
+## Evidence
+
+Book I, Chapter 7: "The natural price, therefore, is, as it were, the
+central price, to which the prices of all commodities are continually
+gravitating. Different accidents may sometimes keep them suspended a good
+deal above it, and sometimes force them down even somewhat below it."
+
+## Feedback Role
+
+This relation is the attractor definition for the Market Price Balancing
+loop — natural price is the equilibrium that both loops (attraction of
+capital when above, flight of capital when below) converge on. It is the
+S2 coordination reference point around which oscillation is suppressed.

examples/infospace-with-history/output/relations/productive_powers_of_labour--raises--profits_of_stock.md

@@ -0,0 +1,39 @@
+# Productive Powers of Labour — raises — Profits of Stock
+
+## Subject
+
+Productive Powers of Labour
+
+## Predicate
+
+raises
+
+## Object
+
+Profits of Stock
+
+## Relation Type
+
+produces
+
+## VSM Channel
+
+S1 → S3 (operational productivity surplus allocated as profit at capital management level)
+
+## Evidence
+
+Book I, Chapter 6: "The value which the workmen add to the materials
+resolves itself into two parts, of which the one pays their wages, the
+other the profits of their employer upon the whole stock of materials
+and wages which he advanced."
+
+## Feedback Role
+
+**Capital Accumulation loop (positive/reinforcing):**
+Accumulation of Stock → enables → Division of Labour → increases →
+Productive Powers of Labour → raises → Profits of Stock → funds →
+Accumulation of Stock.
+
+This edge (raises) is the surplus-extraction link: the productivity gain
+produced by specialisation shows up as profit over and above wage costs,
+generating the fund from which further accumulation occurs.

examples/infospace-with-history/output/relations/profits_of_stock--funds--accumulation_of_stock.md

@@ -0,0 +1,40 @@
+# Profits of Stock — funds — Accumulation of Stock
+
+## Subject
+
+Profits of Stock
+
+## Predicate
+
+funds
+
+## Object
+
+Accumulation of Stock
+
+## Relation Type
+
+produces
+
+## VSM Channel
+
+S3 → S3 (profit retained by capital managers re-enters the stock managed at S3)
+
+## Evidence
+
+Book II, Chapter 3: "Whatever a person saves from his revenue he adds to
+his capital, and either employs it himself in maintaining an additional
+number of productive hands, or enables some other person to do so, by
+lending it to him for an interest."
+
+## Feedback Role
+
+**Capital Accumulation loop (positive/reinforcing):**
+Accumulation of Stock → enables → Division of Labour → increases →
+Productive Powers of Labour → raises → Profits of Stock → funds →
+Accumulation of Stock.
+
+This edge (funds) closes the loop: profit not consumed becomes saving,
+and saving becomes the new stock that enables the next round of division
+of labour. This is why Smith regards frugality as a public virtue — it
+fuels productive capacity rather than dissipating it.

examples/infospace-with-history/output/relations/rent_of_land--regulated_by--market_price_of_commodities.md

@@ -0,0 +1,37 @@
+# Rent of Land — regulated by — Market Price of Commodities
+
+## Subject
+
+Rent of Land
+
+## Predicate
+
+regulated by (rent is a residual after wages and profit are paid)
+
+## Object
+
+Market Price of Commodities
+
+## Relation Type
+
+is regulated by
+
+## VSM Channel
+
+S2 → S3 (price signal determines what residual rent the land can command)
+
+## Evidence
+
+Book I, Chapter 11: "Rent, it is to be observed, therefore, enters into
+the composition of the price of commodities in a different manner from
+wages and profit. High or low wages and profit are the causes of high or
+low price; high or low rent is the effect of it."
+
+## Feedback Role
+
+This relation establishes rent as a **residual** in the price decomposition
+rather than a cost that determines price. It places Rent of Land in a
+structurally subordinate position to the Market Price mechanism — rent
+takes what is left after labour and capital have been paid, rather than
+competing with them as a co-equal cost component. This is Smith's
+sharpest break from the physiocrats.

examples/infospace-with-history/output/relations/wages_of_labour--regulated_by--accumulation_of_stock.md

@@ -0,0 +1,39 @@
+# Wages of Labour — regulated by — Accumulation of Stock
+
+## Subject
+
+Wages of Labour
+
+## Predicate
+
+regulated by (set by the demand for labour, which tracks capital growth)
+
+## Object
+
+Accumulation of Stock
+
+## Relation Type
+
+is regulated by
+
+## VSM Channel
+
+S3 → S2 (capital stock sets demand for labour, which sets the wage coordination signal)
+
+## Evidence
+
+Book I, Chapter 8: "The demand for those who live by wages, therefore,
+necessarily increases with the increase of the revenue and stock of every
+country, and cannot possibly increase without it. The increase of revenue
+and stock is the increase of national wealth."
+
+## Feedback Role
+
+**Wages Expansion loop (positive/reinforcing):**
+Accumulation of Stock → raises demand for labour → raises Wages of Labour
+→ raises consumer capacity → stimulates Productive Powers of Labour →
+generates surplus → funds Accumulation of Stock.
+
+This edge (regulated by) establishes the first link: the wage rate
+responds to the growth of capital stock, not to the current stock level
+directly. Rapid accumulation raises wages; stationary stock does not.

examples/infospace-with-history/output/relations/wages_of_labour--regulated_by--profits_of_stock.md

@@ -0,0 +1,39 @@
+# Wages of Labour — regulated by — Profits of Stock
+
+## Subject
+
+Wages of Labour
+
+## Predicate
+
+regulated by (bounded above by)
+
+## Object
+
+Profits of Stock
+
+## Relation Type
+
+is regulated by
+
+## VSM Channel
+
+S3 → S2 (capital management sets the upper bound on the coordination signal)
+
+## Evidence
+
+Book I, Chapter 8: "In order to bring up a family, the labour of the
+husband and wife together must, even in the lowest species of common
+labour, be able to earn something more than what is precisely necessary
+for their own maintenance; but in what is commonly called common labour
+it is rare that a single labourer earns much more... The interests of
+the two parties are by no means the same. The workmen desire to get as
+much, the masters to give as little as possible."
+
+## Feedback Role
+
+This relation establishes the distributional constraint that bounds
+the Wages loop. Profits of Stock and Wages of Labour are in permanent
+tension: every increase in one (holding productivity constant) reduces
+the other. This is Smith's clearest statement of class interest as a
+structural feature of market economies.

examples/infospace-with-history/schemas/relation-schema-v1.0.md

@@ -0,0 +1,139 @@
+# Relation Triplet Schema — v1.0
+
+Each file in `output/relations/` captures a single directed relation between
+two entities from the L1 entity collection. Relations are the edges of the
+L3 relation graph.
+
+---
+
+## Required Sections
+
+### H1 — Relation title
+
+Format: `# Subject — predicate phrase — Object`
+
+Example: `# Division of Labour — limited by — Market Extent`
+
+---
+
+### Subject
+
+The entity that is the **source** of the relation — the thing doing the
+enabling, constraining, producing, etc.
+
+Use the entity's exact title as it appears in its L1 entity file (H1 heading).
+
+---
+
+### Predicate
+
+A short phrase from the **controlled relation vocabulary** (see below), or
+a natural language variant that maps to one of those classes.
+
+Examples: `limited by`, `enables`, `is regulated by`, `produces`
+
+---
+
+### Object
+
+The entity that is the **target** of the relation — the thing being enabled,
+constrained, regulated, etc.
+
+Use the entity's exact title as it appears in its L1 entity file.
+
+---
+
+### Relation Type
+
+The **semantic class** of the predicate, drawn from the controlled vocabulary:
+
+| Relation Type | Meaning | Default VSM Channel |
+|---|---|---|
+| `enables` | Subject makes object possible or more effective | S1 → S1 |
+| `constrains` | Subject limits or bounds the object | S1 ← S1 |
+| `regulates` | Subject actively governs the object | S3 → S1 |
+| `is regulated by` | Object governs the subject | S1 ← S3 |
+| `coordinates` | Subject reduces oscillation or misalignment | S2 |
+| `produces` | Subject generates the object as output | S1 |
+| `consumes` | Subject depletes the object | S1 |
+| `monitors` | Subject observes and reports on object | S3* |
+| `audits` | Subject verifies compliance of object | S3* |
+| `adapts to` | Subject adjusts in response to object | S4 |
+| `anticipates` | Subject predicts or models the object | S4 |
+| `defines` | Subject sets the identity or rules of object | S5 → any |
+| `is defined by` | Object sets the identity or rules of subject | any ← S5 |
+| `contradicts` | Subject is in direct logical conflict with object | any |
+| `tensions with` | Subject and object exist in productive tension | any |
+
+---
+
+### VSM Channel
+
+The Viable System Model systems involved in this relation, with direction.
+
+Format: `S<n> → S<m>` or `S<n>` if the relation is within a single system.
+
+Examples:
+- `S1 → S2` — operation drives a coordination signal
+- `S3 → S1` — management regulates operations
+- `S2` — pure coordination within S2
+- `S4 → S5` — intelligence informing policy
+
+Use `S3*` for audit loops (Beer's algedonic channel).
+
+---
+
+### Evidence
+
+Direct textual evidence from Adam Smith's text. Preferred format:
+
+```
+Book I, Chapter 3: "The division of labour is limited by the extent of the market."
+```
+
+Use short quotes when available. Chapter reference alone is acceptable when
+no single sentence captures the relation.
+
+---
+
+### Feedback Role (optional)
+
+If this relation is part of a named feedback loop, describe its role here.
+Name the loop and state what the relation contributes.
+
+Example:
+```
+Part of the Market Expansion loop: larger market → more specialisation
+→ higher productivity → greater surplus → expanded trade → larger market.
+This edge (limited by) is the constraining link that turns the loop balancing
+when market extent cannot grow further.
+```
+
+Omit or leave empty if the relation is not part of a known feedback loop.
+
+---
+
+## File Naming
+
+Use the pattern: `<subject-slug>--<relation-type>--<object-slug>.md`
+
+Where slugs are derived from entity titles using the same slugification as
+entity files (lowercase, spaces and punctuation replaced with underscores).
+
+Example: `division_of_labour--constrains--market_extent.md`
+
+If two entities have the same relation type between them (unusual), append
+a numeric suffix: `...-2.md`.
+
+---
+
+## Completeness Criteria
+
+A relation file is **complete** if:
+- All four required sections are present and non-empty
+- The Relation Type is from the controlled vocabulary
+- The VSM Channel is a valid VSM system designation
+- Evidence references a specific Book and Chapter
+
+A relation file is **acceptable** if:
+- Required sections present but Evidence is missing (mark as `(unverified)`)