tegwick
fecc2fd4fa
Implements markitect/llm/ package with concrete LLMAdapter implementations:
- OpenRouterAdapter: HTTP via urllib with retry/backoff on 429/5xx
- ClaudeCodeAdapter: subprocess-based Claude CLI with stdin piping
- Factory pattern: create_adapter("openrouter") or create_adapter("claude-code")
- API key resolution chain: constructor > env var > project-root key file
- 42 unit tests, 2 integration tests (gated on API key / CLI availability)
Also adds the infospace-with-history example with Wealth of Nations VSM
analysis pipeline, templates, schemas, source chapters, and processed
output for chapters 1-2. process_chapters.py now supports --provider
and --model flags for automatic LLM-driven processing.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
7.3 KiB
Chapter Analysis: Book I, Chapter 2 — Of the Principle which gives Occasion to the Division of Labour
Chapter Summary
Smith identifies the cause of the division of labour: a fundamental human propensity to "truck, barter, and exchange." This propensity is not the product of deliberate design or wisdom but an innate (or at least deeply rooted) feature of human nature, possibly derived from the faculties of reason and speech. Smith argues that in civilised society, individuals cannot secure the co-operation of the multitudes they need through benevolence alone; instead, they must appeal to others' self-interest through bargaining. The celebrated passage on the butcher, brewer, and baker establishes self-interest mediated by exchange as the reliable foundation of economic co-operation. Smith then traces how exchange gives rise to specialisation in primitive societies — the armourer, carpenter, smith, and tanner emerge because each finds it advantageous to dedicate themselves to what they do best and trade the surplus. He concludes with the striking claim that the difference of talents between a philosopher and a street porter is largely the effect rather than the cause of the division of labour, and contrasts humans with animals whose diverse natural talents cannot be pooled because they lack the capacity for exchange.
Entities Extracted
| # | Entity | Type | Economic Domain | Description |
|---|---|---|---|---|
| 1 | Propensity to truck, barter, and exchange | Concept | General Theory | Fundamental human disposition to trade, the cause of the division of labour |
| 2 | Self-interest | Concept | General Theory | Motivation to pursue own advantage as the basis of economic co-operation |
| 3 | The bargain | Mechanism | Exchange | Voluntary bilateral exchange — the atomic unit of economic interaction |
| 4 | Benevolence | Concept | General Theory | Goodwill-based co-operation, insufficient for complex economies |
| 5 | Surplus produce | Concept | Production | Output exceeding own consumption, available for exchange |
| 6 | Difference of talents | Concept | General Theory | Skill variation as effect (not cause) of the division of labour |
| 7 | Common stock | Concept | Exchange | Aggregate pool of goods created by specialised exchange |
Total entities: 7
VSM Mappings
| Entity | VSM Concept | Strength | Key Rationale |
|---|---|---|---|
| Propensity to exchange | S5 (Policy/Identity) | Moderate | Foundational identity principle of the economic system |
| Propensity to exchange | S2 (Coordination) | Strong | Prerequisite for all market coordination |
| Self-interest | S1 (Operations) | Strong | Animating principle of autonomous operational units |
| Self-interest | Autonomy | Strong | Operational self-direction as design principle |
| The bargain | S2 (Coordination) | Strong | Atomic unit of inter-S1 coordination |
| Benevolence | S2 (Coordination) | Weak | Insufficient low-variety coordination mechanism |
| Surplus produce | Variety | Moderate | Material substrate of economic variety |
| Difference of talents | Variety | Moderate | System-generated variety through specialisation |
| Common stock | Viability | Moderate | Emergent system capacity to sustain all members |
Total mappings: 9 (some entities map to multiple VSM concepts)
VSM Coverage
| System | Covered | Entities Mapped | Notes |
|---|---|---|---|
| S1 (Operations) | Yes | Self-interest | As autonomy principle of operational units |
| S2 (Coordination) | Yes | Propensity to exchange, the bargain, benevolence | Central theme — exchange as coordination |
| S3 (Control) | No | — | No regulatory or management entities |
| S3* (Audit) | No | — | No monitoring entities |
| S4 (Intelligence) | No | — | No environmental scanning entities |
| S5 (Policy) | Yes | Propensity to exchange | As system identity (moderate mapping) |
| Recursion | No | — | Not addressed in this chapter |
| Variety | Yes | Surplus produce, difference of talents | System-generated variety |
| Requisite Variety | Partial | Benevolence (implicitly) | Benevolence lacks requisite variety for complex economies |
| Attenuation/Amplification | No | — | Not directly addressed |
| Algedonic Signals | No | — | Not addressed |
| Autonomy | Yes | Self-interest | Core argument of the chapter |
| Viability | Yes | Common stock | Pooled resources sustain the system |
Systems covered: S1, S2, S5 (3 of 5 primary systems) Systems not covered: S3, S3, S4* Key concepts covered: Variety, Autonomy, Viability (3 of 7), Requisite Variety (partial)
Gaps & Observations
Uncovered Systems
- S3 (Control): No discussion of regulation, resource allocation, or internal management. Expected — this chapter is about the origin of economic organisation, not its governance.
- S3 (Audit)*: No monitoring or verification mechanisms discussed.
- S4 (Intelligence): Unlike Chapter 1 (which discussed the philosopher and invention), this chapter does not address adaptation or environmental scanning.
Difficult Mappings
- Propensity to exchange → S5 is interpretive. It captures identity/ethos rather than deliberate governance, stretching the usual structural reading of S5.
- Benevolence → S2 is a negative mapping — Smith's point is that benevolence fails as a coordination mechanism. Useful for what it reveals about requisite variety but not a functional S2 element.
Emerging Themes
-
S2 deepens significantly: Chapter 1 introduced exchange as one mechanism among several; Chapter 2 establishes it as the foundational principle of all economic coordination. S2 is now the best-covered system across the two chapters.
-
Autonomy emerges as key concept: Smith's self-interest argument maps powerfully to Beer's autonomy principle. This was implicit in Chapter 1 but becomes explicit here — the system works because its agents are self-directed.
-
Variety appears for the first time: Surplus produce and the difference of talents introduce variety as a property of the economic system. Smith's argument about talents being effects of specialisation describes a variety-amplification feedback loop.
-
S5 begins to emerge: The propensity to exchange as a defining characteristic of human economic nature provides the first (tentative) S5 mapping.
Cross-chapter Connections
- Exchange (Chapter 1 entity) is now grounded in a deeper causal explanation: it arises from the propensity to truck, barter, and exchange.
- The workman (Chapter 1) is now understood as an autonomous agent driven by self-interest, not merely an operative unit.
- Universal opulence (Chapter 1) is explained by the common stock mechanism: diverse talents pooled through exchange.
Cumulative VSM Coverage (Chapters 1-2)
| System | Ch.1 | Ch.2 | Combined |
|---|---|---|---|
| S1 | Strong | Yes | Strong |
| S2 | Yes | Strong | Strong |
| S3 | No | No | No |
| S3* | No | No | No |
| S4 | Yes | No | Yes |
| S5 | No | Moderate | Moderate |
| Variety | No | Yes | Yes |
| Autonomy | No | Yes | Yes |
| Viability | Yes | Yes | Yes |