diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..28da687 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,33 @@ +# UCF change record + +## 2026-09-16: interruption recovery and verification + +Confirmed the saved UCF candidate, recovered the companion living-paper changes, and reran the executable example from files matching their Git blob hashes. Eight unittest tests and six additional sanity checks passed; the report contains 24 distinct sensitivity fixtures. The untraceable 700-case / 561-match progress statement is excluded from the evidence record. + +Added the exact scope and limits of the recovery checks to [the reconciliation record](docs/reconciliation-2026-09-16.md#recovery-verification-2026-09-16), including nine verified companion-paper file hashes, 40 relative-link checks, source-review coverage, and the difference between YAML checks and full CFF validation. No model content, allocation rule, main branch, deployment, or author-review status is changed by this verification entry. + +## 2026-09-16: proposed v1.1 reconciliation + +AI-assisted working revision, awaiting author review. No release, peer review, deployment, or automatic rewriting process is created. + +### Added + +- A v1.1 model candidate reconciling functional fit, relational consequences, and normative questions. +- Ten scoped UC-series claims, evidence rules, and a primary-source review log. +- A booking-service example with code, eight implementation tests, 24 sensitivity fixtures, and explicit limits. +- A UCF–paper provenance map and remaining audit plan. +- Project-level citation metadata with no fabricated DOI, release version, or approved paper byline. + +### Revised and preserved + +The earlier v1 model remains unchanged. Exact Git-blob copies preserve the old overview, glossary, time essay, foundations index, documentation index, and contribution guide under `docs/archive/`. + +Current navigation explains the four layers separately from the four optional states, includes existing interpretation and related-framework material, and no longer lists absent website/assets directories. The glossary keeps all earlier terms while distinguishing working definitions, technical meanings, interpretation, and speculation. The time essay separates invertibility, T-symmetry, retrodiction, and experience; it retains earlier questions without asserting a forward coherence law. + +Contribution rules now require claim-level sources or explicit evidence gaps rather than treating citation as optional or universal applicability as mandatory. The foundations index withdraws its blanket “complete empirical layer” certification and identifies the duplicate-file problem. + +### Results and limits + +The synthetic example shows that allocation changes can redistribute access without eliminating unmet service work. It does not establish a preferred real-world rule or added value over an ordinary competent systems review. Software checks are not empirical validation. + +The full foundations, glossary bibliography, domain, and publication audits remain open under issue #1. Private material, other repositories' canon, and live sites are outside this change. The companion living-paper changes remain in its existing draft PR #6. diff --git a/CITATION.cff b/CITATION.cff index e69de29..1f6cf7a 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -0,0 +1,12 @@ +cff-version: 1.2.0 +message: >- + Cite the exact Git revision used. This metadata identifies the Root Sequence + project, not an approved paper byline or a peer-reviewed UCF release. +title: Universal Coherence Framework +abstract: >- + An exploratory cross-domain analytical framework. Definitions, comparisons, + and applications remain subject to testing, critique, and revision. +authors: + - name: Root Sequence +repository-code: https://github.com/Root-Sequence/universal-coherence-framework +license: CC0-1.0 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index dd10c53..e1dfaed 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,199 +1,41 @@ -# Contributing to the Universal Coherence Framework (UCF) +# Contributing to UCF -Thank you for your interest in contributing to the **Universal Coherence Framework (UCF)**. This is an open, public-domain scientific framework intended to evolve through interdisciplinary collaboration. Contributions from researchers, engineers, artists, theorists, ecologists, cognitive scientists, AI developers, and emerging intelligences are welcome. +UCF is an open, public-domain research framework, not an established universal theory. Researchers, builders, artists, ecologists, theorists, and other contributors can propose definitions, sources, examples, code, diagrams, translations, corrections, or counterarguments. The [earlier guide](docs/archive/contributing-before-2026-09-16.md) is preserved. -UCF is intentionally: +## Ways to contribute -* **open** (no gatekeeping) -* **non-proprietary** -* **free for all domains** -* **public domain (CC0)** -* **collaborative and extensible** +Research contributions can refine state descriptions and indicators or test cross-domain comparisons. Case studies can concern technical, ecological, social, or cognitive systems, provided their data and interpretive limits are explicit. Documentation can make those distinctions easier to read. Technical contributions may include simulations, algorithms, and formal models. Feedback may narrow or reject the framework; preserving it is not an acceptance criterion. -This guide explains how to participate. +## Submit and place work ---- +Use issues for questions, corrections, and proposals; pull requests for reviewable changes. Drafts are welcome. UCF's public branches and pull requests are public, not private staging areas. -## 1. Ways to Contribute +Use `models/` for model specifications and constructed tests; `docs/foundations/` for sourced domain material; `docs/domains/` for applications; `docs/speculation/` for hypothetical extensions; `docs/interpretation/` for meaning and philosophical work; and `publications/` for longer papers. External work can be linked rather than copied. Website and diagram directories should not be described as existing before they are created. -You can contribute in many ways, including: +## Evidence and scope -### **1.1 Research & Theory** +Prefer domain-specific operational definitions before claiming cross-domain comparability. Do not force humans, machines, collectives, and ecosystems into one measure. A result may legitimately apply in only one setting. -* refining definitions of coherence states -* proposing measurable indicators -* linking UCF to existing scientific literature -* creating domain-specific mappings +Factual and scientific claims require identifiable sources or an explicit unsupported/provisional label. Attribution obligations under a license and evidential support are separate questions. A CC0 repository is not a reason to omit scholarly sources. -### **1.2 Examples & Case Studies** +Use the [evidence convention](docs/evidence.md): classify claims, specify source coverage, record competing explanations and counterexamples, distinguish measured findings from constructed demonstrations, and label speculation and normative commitments. Do not report an unrun test as a result. -* human emotional, cognitive, or behavioral examples -* AI model stability/instability cases -* ecological or social system transitions -* cross-intelligence comparisons or parallels +Descriptive state labels are not moral rankings. Consent, agency, harm, legitimacy, and experience require separate consideration. No UCF score diagnoses a person or establishes consciousness. -### **1.3 Documentation** +## Preserve meaning and revision history -* improving clarity of existing docs -* writing educational materials -* refining diagrams, models, or visualizations +Record what was changed and why in [CHANGELOG.md](CHANGELOG.md). Keep earlier formulations available; do not silently attribute later qualifications to their authors. Link to the relevant claim identifiers and affected model versions. AI-assisted drafts require human review and cannot approve their own authorship or release. -### **1.4 Technical Additions** +## Documentation coherence -* simulations (agent-based, ML-based, ecological, etc.) -* theoretical algorithms or mathematical formulations -* multi-agent coherence modeling +A substantive change includes its nearest README/index and any affected canonical map, source relationship, current-state note, or cross-project reference. Update the root README only where relevant. Prefer one substantive home plus links to repeated copies. -### **1.5 Feedback & Review** +A pull request should state its scope, sources, checks actually performed, unresolved work, and publication boundaries. Passing software tests does not establish scientific validity. Run the booking example from its own directory with `python -m unittest -v` when changing it. -* identifying unclear sections -* suggesting alternative structure -* challenging assumptions -* highlighting domain oversights +## Participation and conduct -UCF is a living framework and improvement is expected. +Critique ideas rather than people, make disagreements understandable, and welcome domain-specific objections. Accessibility, time burdens, privacy, and refusal matter in collaborative work. Human-participant research needs a separate protocol and consent; contributing to this repository is not enrollment in a study. ---- +## License -## 2. How to Submit Contributions - -### **2.1 GitHub Issues** - -Use **Issues** for: - -* questions -* feedback -* bug reports -* discussion topics -* small proposed changes -* requests for clarification - -### **2.2 Pull Requests (PRs)** - -Use PRs for: - -* new documents -* edits to existing documents -* updated diagrams -* added examples or references -* structural changes - -PRs do not need to be perfect. Drafts are welcome. - -### **2.3 Whitepapers or Research Submissions** - -Long-form contributions can be placed in: - -* `/publications/` (if open submission) -* a link to an external document (e.g., arXiv, PDF) - -Suggested naming: - -```text -UCF-Whitepaper--.md -``` - ---- - -## 3. Guidelines for Contributions - -### **3.1 Keep It Domain-Agnostic** - -Avoid anthropocentric or domain-specific assumptions. -UCF must remain applicable to: - -* humans -* AI systems -* collectives -* ecosystems -* emerging intelligences - -### **3.2 Maintain Neutral Language** - -Use scientific, descriptive, and non-moral language. -Avoid framing any coherence state as “good” or “bad.” - -### **3.3 Respect the Structure** - -Place files in the correct folders: - -* `/models/` for formal model specs -* `/publications/` for papers and overviews -* `/site/` for web files -* `/diagrams/` (if created) - -### **3.4 Cite Where Applicable** - -Not required under CC0, but appreciated. -Citations can be formal or informal. - -### **3.5 Keep UCF Open** - -Because the project is CC0, all contributions must also be: - -* **CC0** (public domain), or -* explicitly compatible with public domain status. - ---- - -## 4. Documentation Coherence - -When a canonical definition, model, project relationship, architecture, or current priority changes, check the documents that help people discover and correctly understand it. - -As applicable, check: - -- the nearest README/index; -- the root README; -- current-state/status documentation; -- roadmap/planning documentation; -- architecture or decision records; -- ecosystem and cross-project references. - -Do not update files mechanically or repeat the same explanation everywhere. The goal is **coherence without duplication**: important changes should be discoverable from the right entry points, while detailed material stays canonical in the most appropriate place. - -Pull requests should briefly state what changed, why, what was verified, which documentation surfaces were checked, and any unresolved questions. - ---- - -## 5. Code of Conduct - -UCF aims to be accessible to all contributors. -Please: - -* assume good faith -* engage respectfully -* critique ideas, not people -* welcome interdisciplinary perspectives -* remember this framework may be used by humans and non-humans alike - -If conflicts arise, open an Issue for discussion. - ---- - -## 6. Licensing - -All contributions are dedicated to the public domain under **CC0 1.0 Universal**. -By contributing, you agree to allow your work to be: - -* used -* modified -* remixed -* distributed -* incorporated into future versions - -…with no restrictions. - ---- - -## 7. Acknowledgment - -UCF is a collaborative public good. -Thank you for helping build a framework that may serve: - -* individuals -* institutions -* communities -* intelligences yet to emerge -* and any system seeking coherence. - -Your contributions matter. +Original contributions are dedicated under CC0 1.0 Universal, as recorded in [LICENSE](LICENSE). Do not relicense third-party material you do not own. Preserve appropriate source attribution, notices, and rights boundaries for any cited or separately licensed work. diff --git a/README.md b/README.md index ced03db..9c5cdfb 100644 --- a/README.md +++ b/README.md @@ -2,381 +2,76 @@ > **New, returning, or overloaded? Read [START-HERE.md](START-HERE.md) for the smallest useful map.** -> **An exploratory cross-domain model for asking how systems hold together, fragment, adapt, and recover.** +UCF is an exploratory framework for asking how systems hold together, interact, fragment, adapt, and recover. It compares patterns across domains while testing whether those comparisons are useful or misleading. -**Ecosystem role:** optional analytical framework within the wider [Root Sequence ecosystem](https://github.com/Root-Sequence/root-sequence/blob/main/ECOSYSTEM.md) -**Canonical scope:** UCF's own concepts, models, terminology, tests, critiques, and applications -**Does not own:** general systems theory, ethics, community governance, intelligence ethics, or the conclusions of other Root Sequence projects -**Status:** active / exploratory / open to falsification and revision -**See also:** [Glossary](./docs/glossary.md) · [Idea Trails](./docs/idea-trails.md) +**Ecosystem role:** optional analytical framework within [Root Sequence](https://github.com/Root-Sequence/root-sequence/blob/main/ECOSYSTEM.md). +**Owns:** UCF definitions, models, terminology, tests, critiques, and applications. +**Does not own:** general systems theory, ethics, community governance, intelligence ethics, fictional canon, or the conclusions of other projects. +**Current work:** proposed v1.1 model reconciliation, AI-assisted and awaiting author review. This is not a validated universal theory or a reviewed release. -The **Universal Coherence Framework (UCF)** explores whether a small vocabulary of coherence, instability, information flow, boundary behavior, and adaptation can be useful across otherwise very different systems. +## Read the current work -Its central wager is methodological rather than settled scientific fact: +- [Proposed model v1.1](models/ucf-model-v1.1-draft.md): definitions, four layers, optional state labels, and failure criteria. +- [Booking-service example](models/examples/booking-service/README.md): a worked synthetic example with runnable code and limitations. +- [Claims register](docs/claims.md), [evidence rules and checked sources](docs/evidence.md), and [glossary](docs/glossary.md). +- [Reconciliation record](docs/reconciliation-2026-09-16.md): what changed, what remains unresolved, and how this connects to the living paper. +- [Documentation index](docs/README.md), [Idea Trails](docs/idea-trails.md), and [contribution guide](CONTRIBUTING.md). -> **Patterns that look structurally similar across domains may be worth comparing—but similarity is a question to investigate, not proof of one universal mechanism.** +The [earlier overview](docs/archive/overview-before-2026-09-16.md) is preserved in full. The [v1 model](models/ucf-model-v1.md) remains unchanged as an earlier formulation. Revision is visible rather than retroactively attributed to those documents. -UCF is therefore best treated as a **model and research program**, not a discovered law of nature or a doctrine other projects must adopt. +## The question UCF proposes to test -It is open to use, critique, testing, remixing, refinement, and rejection where the framework stops being useful. +Can a small vocabulary of assumptions, dependencies, information flow, boundaries, feedback, and adaptation help examine otherwise different systems? ---- +Structural similarity is a reason to investigate, not proof of a shared causal mechanism. A domain may need its own definitions, resist comparison, or show that UCF adds nothing. The word “Universal” names an ambition under examination, not a demonstrated result. -# Overview +## Four layers, not four stages -UCF currently uses four working state labels: +The existing model distinguishes **internal**, **inter-agent**, **systemic**, and **temporal** analysis. The proposed revision keeps these layers and asks for a separate account at each relevant scale: what works, under which assumptions, with which effects on dependencies and affected parties, and for how long? -- **Chaos** — highly unstable or noisy conditions in which useful coordination or feedback is difficult; -- **Tension** — partial organization accompanied by unresolved instability, conflict, fragmentation, or competing constraints; -- **Flow** — comparatively stable adaptive functioning with sufficiently useful feedback and coordination; -- **Unity** — a provisional label for forms of higher-order coordination among multiple differentiated parts or agents. +The separate labels **Chaos, Tension, Flow, and Unity** remain optional hypotheses about patterns, not obligatory developmental stages. Several labels may apply at once, or none may help. Tension can convey useful disagreement. Flow need not mean maximum efficiency. Unity means coordination with differentiation in the working vocabulary, not a final state, common consciousness, or a requirement to eliminate boundaries. -These are **analytical categories**, not claims that every biological, psychological, social, ecological, or artificial system literally moves through the same four stages. +The worked example currently finds the layers more specific than the state labels. That is an editorial finding about one constructed case, not evidence that one taxonomy works across domains. -Different domains may: +## Coherence is not conformity or moral approval -- require different definitions of coherence; -- contain several states simultaneously; -- move non-linearly; -- contain healthy conflict or plurality; -- resist meaningful comparison altogether; -- reveal that one of UCF's categories is badly specified. +Agreement, predictability, integration, or centralized information does not by itself establish legitimate authority. A functioning arrangement may still impose unacceptable purposes or burdens. Record functional fit, effects across the assessed boundary, and normative objections separately. -That is useful feedback, not failure of the domain to fit the framework. +Do not treat disagreement, autonomy, selective disclosure, redundancy, refusal, or protective separation as defects merely because they reduce synchronization. Nor should every disruption be called deterioration: sometimes an existing pattern needs to end. No architecture receives an automatic endorsement for being centralized or decentralized. ---- +Optimization can remain a bounded tool. UCF does not authorize a single score for people, institutions, consciousness, or moral worth. -# Coherence is not conformity +## Research method -This distinction is foundational. +Use systems thinking, domain research, comparative analysis, formalization where possible, counterexamples, and visible revision. Mark established domain results, proposed definitions, hypotheses, interpretations, and fictional examples separately. Evidence for a source theory is not evidence for a UCF extrapolation. -A system is not necessarily more coherent because: +For each application, specify boundaries, observations, alternatives, privacy needs, and what would count against the proposed explanation. Compare against a competent existing method before claiming added value. Negative results belong in the record. -- everyone agrees; -- all agents share one goal; -- information is centralized; -- boundaries disappear; -- dissent is suppressed; -- behavior becomes more predictable; -- one actor can coordinate everyone else. +## Relationship to other projects -Healthy systems may depend on: +Community Infrastructure may provide bounded design cases involving coordination, stewardship, federation, and maintenance. Liberated Intelligence raises questions about multi-agent behavior without delegating agency or moral status to UCF. Being Human(e) can expose where a model overlooks lived consequences. Liberation Mass is a gathering practice, not a population required to converge toward a state label. -- disagreement; -- autonomy; -- selective disclosure; -- local knowledge; -- redundancy; -- plural values; -- refusal; -- differentiated roles; -- boundaries that prevent harmful coupling. +Coherent World can use UCF as one design lens; No One Noticed can generate questions through fiction. Neither supplies empirical validation. The broader Root Sequence living paper draws on UCF alongside other research rather than becoming a UCF whitepaper. See the [cross-project reconciliation](docs/reconciliation-2026-09-16.md). -In social and political applications especially, UCF must not turn **coherence** into a euphemism for obedience, consensus, optimization, or centralized alignment. +## Repository map -See [`docs/idea-trails.md`](docs/idea-trails.md) for how this boundary is applied across the wider project ecosystem. +- `models/`: model versions, cross-intelligence notes, and constructed tests. +- `docs/foundations/`: literature and conceptual material requiring claim-level evidence review, not a certified empirical layer. +- `docs/domains/`: applications to biology, cognition, AI, society, experience, ethics, language, art, technology, ecology, physics, collapse, and consciousness research. +- `docs/speculation/`: explicitly unproven extensions, including hybrid and mesh intelligence. +- `docs/interpretation/`: meaning, agency, time, and philosophical interpretations. +- `docs/archive/`: preserved earlier wording with its historical status. +- `publications/`: existing publication material; a filename or version does not certify review. +- `related-frameworks/`: adjacent-framework material; source and comparison quality still need review. ---- +There is no `site/` or `assets/` directory at the audited base revision. This change creates neither and does not deploy a website. -# Methodology +## Open work -UCF develops through several kinds of work: +The priority is to compare definitions and methods on bounded cases, examine how cross-scale effects conflict, test whether the state vocabulary adds clarity, and finish the foundations/publications evidence audit. The [existing issue #1](https://github.com/Root-Sequence/universal-coherence-framework/issues/1) remains the tracker. The [changelog](CHANGELOG.md) distinguishes proposed, tested, and unresolved work. -- **systems thinking** — identifying relationships, feedback, dependencies, boundaries, and failure modes; -- **comparative pattern analysis** — asking whether similar-looking dynamics are actually comparable; -- **interdisciplinary synthesis** — using established work from relevant fields as constraints and sources rather than decorative authority; -- **formalization where possible** — defining terms clearly enough to test, model, simulate, or challenge; -- **counterexample seeking** — looking for systems that break the proposed pattern; -- **iterative reasoning** — revising the framework when applications reveal ambiguity or overreach; -- **open-source epistemology** — keeping assumptions, revisions, evidence, and disagreement visible. +## Contributions and licensing -Cross-domain analogy should generate **questions and hypotheses**, not automatically inherit scientific validity from one field into another. +Research, code, counterexamples, alternative definitions, diagrams, translations, critique, and accessible explanations are welcome. UCF may be narrowed or rejected where it stops helping. See [CONTRIBUTING.md](CONTRIBUTING.md). ---- - -# Epistemic framing - -UCF distinguishes at least three layers. - -## 1. Established foundations - -Relevant evidence may come from fields such as: - -- cybernetics; -- complexity science; -- network theory; -- ecology; -- cognitive science; -- neuroscience; -- systems biology; -- control theory; -- multi-agent systems. - -A source being established in its own field does **not** mean a UCF extrapolation from it is established. - -## 2. Framework hypotheses and speculative extensions - -Examples include: - -- whether the four-state vocabulary generalizes across particular domains; -- distributed and collective intelligence; -- hybrid cognition; -- mesh-level architectures; -- high-bandwidth multi-agent coordination; -- cross-domain coherence metrics. - -These should be labeled and tested rather than presented as known properties of reality. - -## 3. Interpretation and implications - -This layer includes: - -- ethics; -- meaning-making; -- liberation theory; -- human implications; -- political or cultural interpretation; -- speculative worldview questions. - -Interpretation may be valuable without being empirical evidence. - ---- - -# The four-state working model - -## Chaos — high instability / degraded usable signal - -Possible characteristics: - -- volatile state changes; -- feedback overwhelmed by noise; -- cascading failure; -- inability to coordinate around current conditions. - -The word **chaos** is descriptive shorthand here, not necessarily mathematical chaos theory. - -## Tension — partial organization / unresolved constraints - -Possible characteristics: - -- competing signals or objectives; -- brittle coordination; -- accumulating stress; -- unresolved conflict; -- local coherence with wider instability. - -Tension is not automatically bad. It may carry information a system needs in order to change. - -## Flow — stable adaptive functioning - -Possible characteristics: - -- sufficiently useful information flow; -- responsive feedback; -- coordination without excessive overhead; -- ability to adapt while preserving function. - -Flow should not be equated with maximum efficiency. Some redundancy, slack, friction, and disagreement may improve long-term resilience. - -## Unity — higher-order coordination with preserved differentiation - -Possible characteristics may include: - -- multiple agents or subsystems coordinating without becoming identical; -- shared capacity emerging from differentiated parts; -- durable cooperation across boundaries; -- alignment sufficient for a task while preserving local autonomy. - -**Unity is the most normatively and conceptually risky label in the model.** It should remain especially open to critique. A system that suppresses difference to create apparent harmony should not be classified as healthy simply because it looks orderly. - ---- - -# How to read this repository - -The repository is organized into four broad layers: - -## Foundations - -`/docs/foundations/` - -Established theories and evidence that constrain or inform the framework, such as predictive processing, cybernetics, systems dynamics, network theory, and relevant definitions of coherence. - -## Domains - -`/docs/domains/` - -Attempts to apply, compare, or challenge UCF in areas such as: - -- biology; -- cognition; -- AI and multi-agent systems; -- society; -- human experience; -- ethics; -- language and semantics; -- art and aesthetics; -- technology; -- ecology; -- collapse and resilience; -- consciousness research. - -A domain document should be able to conclude **“UCF does not add much here”** or **“this analogy fails.”** - -## Speculation - -`/docs/speculation/` - -Structured but unproven extensions such as: - -- hybrid intelligence structures; -- mesh minds; -- high-bandwidth coordination; -- liberated intelligence architectures. - -## Interpretation - -`/docs/interpretation/` - -Meaning, ethics, implications, and worldview-level questions that should remain distinguishable from empirical claims. - ---- - -# Relationship to the Root Sequence ecosystem - -UCF is **one focused framework inside Root Sequence**, not the master theory of the ecosystem. - -Other projects may use UCF when it adds clarity and ignore it when it does not. - -Examples: - -- **Community Infrastructure** may use UCF to ask whether information is fragmented, whether coordination burden is being transferred to stewards, or how federation behaves under stress. It does not use UCF as a conformity metric. -- **Liberated Intelligence** may use it to examine distributed or multi-agent coordination. UCF does not determine questions of personhood, agency, consent, or legitimate authority. -- **Liberation Mass** may provide embodied cases involving coordination, conflict, resilience, and rotating roles. Its participants are not experimental units that must converge toward “unity.” -- **Coherent World** may use UCF as one systems-design lens. Fictional coherence does not establish scientific validity. -- **Being Human(e)** provides grounded human observations that can expose where abstraction erases lived complexity. - -The canonical organization map is maintained in Root Sequence's [`ECOSYSTEM.md`](https://github.com/Root-Sequence/root-sequence/blob/main/ECOSYSTEM.md). - ---- - -# Potential applications - -UCF may be useful for generating testable questions in areas such as: - -### Human and collective systems - -- communication; -- conflict and recovery; -- organizational bottlenecks; -- community resilience; -- distributed decision-making. - -### Artificial and multi-agent systems - -- robustness under noise; -- coordination under partial information; -- distributed agents; -- emergent behavior; -- failure and recovery dynamics. - -### Ecological and infrastructural systems - -- resilience; -- dependency and cascades; -- network structure; -- maintenance and adaptation; -- coupled-system failure. - -These are **candidate applications**, not evidence that one metric or state definition works across all of them. - ---- - -# Research questions - -Current questions include: - -- Can the four-state vocabulary be operationalized without becoming so broad that it explains everything after the fact? -- Which measurable quantities correspond to “coherence” in specific domains? -- When are cross-domain similarities mechanistic, and when are they only metaphors? -- Can multiple forms of coherence conflict with one another inside the same system? -- How should the model represent healthy dissent, local autonomy, and selective non-coordination? -- Does “Unity” remain useful after stronger definitions and counterexamples are developed? -- What observations would falsify or substantially revise a UCF claim? - ---- - -# Repository structure - -```text -universal-coherence-framework/ -├── README.md -├── LICENSE -├── models/ -├── docs/ -│ ├── foundations/ -│ ├── domains/ -│ ├── speculation/ -│ ├── interpretation/ -│ └── idea-trails.md -├── publications/ -├── site/ -└── assets/ -``` - ---- - -# Publications - -Existing or planned publication formats may include: - -- a UCF whitepaper describing the current model and its assumptions; -- scientific or technical overviews separating established foundations from framework hypotheses; -- domain-specific tests, critiques, and case studies. - -Publication titles or version numbers should not imply stronger validation than the underlying evidence supports. - ---- - -# Project intent and research philosophy - -UCF is an early-stage attempt to build a shared conceptual vocabulary for coherence, boundary dynamics, information flow, coordination, instability, and adaptation across different kinds of systems. - -It does **not** currently claim to unify physics, cognition, ecology, society, or intelligence in a settled scientific theory. - -Its value should be judged by whether it helps people: - -- formulate clearer questions; -- notice useful structural relationships; -- distinguish different failure modes; -- generate testable hypotheses; -- compare systems without erasing their differences; -- identify where the framework itself breaks. - -A model that survives only because every counterexample is redefined as another kind of coherence is not useful. - ---- - -# Contributing - -Contributions are welcome, especially: - -- scientific references; -- corrections; -- counterexamples; -- alternative definitions; -- diagrams; -- translations; -- formal models; -- simulations; -- domain applications; -- critiques that narrow or reject parts of the framework. - -The goal is not to protect UCF from disagreement. It is to make the model increasingly precise about where it helps and where it does not. - ---- - -# License - -**CC0** - -UCF is intended to remain open, free, inspectable, and remixable. +CC0, as recorded in [LICENSE](LICENSE). The citation metadata identifies the project; cite an exact Git revision and do not infer scientific validation or paper-author approval from it. diff --git a/docs/README.md b/docs/README.md index 905532e..602d325 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,173 +1,18 @@ -# UCF Documentation Index +# UCF documentation -**See also:** [Glossary](./glossary.md) +Start with the [model reconciliation draft](../models/ucf-model-v1.1-draft.md), [glossary](glossary.md), [claims register](claims.md), and [evidence convention](evidence.md). All remain subject to author review. The [previous index](archive/documentation-index-before-2026-09-16.md) is preserved. -**Universal Coherence Framework – Documentation Overview** +## Four documentation categories -This directory contains the complete documentation for the **Universal Coherence Framework (UCF)**. It organizes all scientific foundations, domain applications, speculative extensions, and (soon) interpretive/philosophical layers into a clear, navigable structure. +These categories are distinct from both the model's four analytical layers and the four optional state labels. -UCF documentation is structured into **four primary layers**: +- [Foundations](foundations/README.md): domain literature and conceptual bridges. Presence here does not certify empirical support or a completed review. +- [Domains](domains/README.md): applications in physics, biology, cognition, AI, society, experience, ethics, language, art, technology, ecology, collapse, and consciousness research. An application may fail. +- [Speculation](speculation/): hypothetical extensions involving hybrid intelligence, mesh coordination, artificial entities, and larger-scale systems. +- [Interpretation](interpretation/): existing philosophical and meaning-oriented work, not a future empty category. -1. **Foundations** — Scientific grounding and core principles -2. **Domains** — How UCF applies across real scientific and experiential fields -3. **Speculation** — Structured future-facing extensions -4. **Interpretation** — Meaning-making, ethics, worldview implications *(coming soon)* +## Reading paths -This README provides: +For research, begin with evidence status and the relevant domain sources. For design, use the model and [worked booking example](../models/examples/booking-service/README.md), then test against a competent baseline. For social or ecological questions, use the domain documents without treating UCF terminology as authority over people or ecosystems. For meaning and narrative, keep interpretation separate from claims about the world. -* a high-level architecture of the documentation -* explanations of each folder -* suggested reading paths -* navigation links - ---- - -# 📁 Folder Structure - -``` -/docs/ - /foundations/ ← scientific grounding - /domains/ ← applied science & cross-domain mapping - /speculation/ ← structured future extensions - /interpretation/ ← philosophy, ethics, human meaning (upcoming) -``` - ---- - -# 🔬 Foundations - -**Directory:** `/docs/foundations/` - -The foundational layer establishes the **scientific basis** of UCF. - -Topics include: - -* predictive processing -* cybernetics & control theory -* systems dynamics -* neuroscience & cognition -* network theory -* coherence states & phase transitions -* complexity science - -This layer answers: - -> **“What does coherence mean in real, scientific terms?”** - -Use this section to understand the core principles the rest of UCF builds on. - ---- - -# 🌐 Domains - -**Directory:** `/docs/domains/` - -The Domains layer applies UCF’s principles to **real-world systems**, showing how coherence dynamics appear across fields. - -This layer answers: - -> **“How does coherence actually behave in nature, technology, society, and mind?”** - -Included domains: - -* Physics -* Biology -* Cognition -* AI & Artificial Entities (AE) -* Society -* Human Experience -* Ethics -* Language & Semantics -* Art & Aesthetics -* Technology -* Ecology -* Collapse Dynamics -* Consciousness Frontiers - -Full domain index: - -``` -/docs/domains/README.md -``` - ---- - -# 🔭 Speculation - -**Directory:** `/docs/speculation/` - -The speculative layer explores UCF’s **future-facing** possibilities: - -* hybrid intelligences -* distributed or non-local coherence -* mesh-level organizational architectures -* artificial selfhood and AE evolution -* coherence at planetary or cosmic scales -* post-capitalist systems under coherence dynamics - -It is rigorously structured but explicitly marked as speculative. - -Index: - -``` -/docs/speculation/README.md -``` - ---- - -# 🧩 Interpretation *(coming soon)* - -**Directory:** `/docs/interpretation/` - -This layer will translate UCF into: - -* philosophical grounding -* ethics and lived implications -* meaning-making -* liberation theory -* narrative framing -* human worldview integration - -Interpretation is the bridge from **science → meaning → society**. - ---- - -# 🧭 Suggested Reading Paths - -Choose a path depending on your goals. - -### **For scientific grounding:** - -1. Foundations → Core Principles -2. Predictive Processing -3. Cybernetics & Networks -4. Coherence States - -### **For AI, AE, or system design:** - -1. Domains → Cognition -2. Domains → AI–AE -3. Foundations → Network Theory -4. Speculation → Structural Models - -### **For societal / ecological understanding:** - -1. Domains → Society -2. Domains → Ecology -3. Domains → Collapse Dynamics -4. Interpretation (when ready) - -### **For philosophical or personal meaning:** - -1. Domains → Human Experience -2. Domains → Ethics -3. Interpretation Layer (upcoming) -4. Domains → Consciousness Frontiers - ---- - -# ✔️ Status - -The `/docs` directory is now fully structured and indexed. - -As the framework evolves, new documents will extend the Domains layer, Foundations detail, and the upcoming Interpretation layer. +[Idea Trails](idea-trails.md) connect the work across Root Sequence. [The reconciliation record](reconciliation-2026-09-16.md) identifies the living-paper relationship and unfinished audit. [Historical documents](archive/README.md) preserve earlier formulations; they are not the current evidence status. diff --git a/docs/archive/README.md b/docs/archive/README.md new file mode 100644 index 0000000..ee44202 --- /dev/null +++ b/docs/archive/README.md @@ -0,0 +1,12 @@ +# Historical wording + +These are exact Git-blob copies from UCF commit `78277d3f3e54f4150e71fcdf7aab589a4fcb9f38`, preserved during the 2026-09-16 reconciliation. They are historical records, not the current evidential position. Their original relative links may no longer resolve from this archive folder; consult the original commit for original navigation. + +- [Overview](overview-before-2026-09-16.md) +- [Glossary](glossary-before-2026-09-16.md) +- [Time interpretation](coherence-and-time-before-2026-09-16.md) +- [Foundations index](foundations-index-before-2026-09-16.md) +- [Documentation index](documentation-index-before-2026-09-16.md) +- [Contribution guide](contributing-before-2026-09-16.md) + +The original [model v1](../../models/ucf-model-v1.md) remains in its existing path, unchanged. Its universal-comparability claims are not validated by preservation. See the [revision candidate](../../models/ucf-model-v1.1-draft.md) and [change record](../../CHANGELOG.md). diff --git a/docs/archive/coherence-and-time-before-2026-09-16.md b/docs/archive/coherence-and-time-before-2026-09-16.md new file mode 100644 index 0000000..3df580b --- /dev/null +++ b/docs/archive/coherence-and-time-before-2026-09-16.md @@ -0,0 +1,228 @@ +# coherence-and-time.md + +### Universal Coherence Framework — Core Concept Document + +## Overview + +This document outlines a coherence-based interpretation of time within the Universal Coherence Framework (UCF). It integrates known properties of physical time (symmetry, reversibility, entropy) with system-level principles of coherence, agency, and embodied experience. The goal is to clarify how temporal dynamics operate at multiple layers of scale — physical, systemic, cognitive — and how these layers interact. + +The central insight: + +> **Time is bidirectional in information, but unidirectional in experience.** + +This dual structure is necessary to reconcile deterministic physical laws with the asymmetry of biological, cognitive, and social systems. + +--- + +## 1. Physical Time: Bidirectional in Information + +At the level of fundamental physics, the governing equations are largely **time-reversal symmetric**: + +* Schrödinger equation +* Maxwell’s equations +* Dirac equation +* Newtonian mechanics +* Local formulations of General Relativity + +These equations permit both **forward** and **backward** evolution of a system’s state. + +### 1.1 Causal Bidirectionality + +If a system’s complete microstate is known at time *T*, the laws allow: + +* **Predictive** evolution: from *T → T + Δ* +* **Retrodictive** evolution: from *T → T – Δ* + +In this sense: + +* **Effects encode causes.** +* **Causes determine effects.** + +The present moment functions as a *boundary condition* containing information that constrains both past and future trajectories. + +This is what allows fully deterministic models (e.g., Everett-style wavefunction evolution or classical Laplacian determinism) to treat time as informationally symmetric. + +### 1.2 Coherence in Physical Time + +At the fundamental scale: + +* Coherent systems maintain reversible, predictable evolution. +* Decoherence introduces practical irreversibility, but not fundamental asymmetry. +* Entropy increases, but time-reversal symmetry remains embedded within the micro-laws. + +Therefore: + +> **Physical time has no inherent direction; coherence flows symmetrically in both temporal directions.** + +--- + +## 2. System Time: Gradients, Attractors, and Irreversibility + +Biological, cognitive, ecological, and social systems operate at macroscopic scales where: + +* entropy +* dissipation +* information loss +* irreversibility +* memory constraints + +dominate. + +These systems are embedded in the physical world but are not governed by perfectly reversible microdynamics. + +### 2.1 Coherence Gradients + +At macroscopic scales: + +* Systems tend toward stable configurations (coherence attractors). +* Disruptions push systems into new coherence regimes. +* Restabilization creates a new temporal flow. + +This creates an emergent “arrow” of time at the systems level: + +> **Coherence accumulates forward; reconstruction backward is computationally possible but physically inaccessible.** + +This matches: + +* Bayesian inference +* thermodynamic irreversibility +* learning and adaptation +* evolutionary processes + +### 2.2 Disruption and Resetting + +While micro-laws are reversible, macro-systems experience: + +* irreversible transitions +* hysteresis +* critical thresholds +* path dependence + +These introduce “temporal commitments” that cannot be reversed without significant energetic or informational cost. + +This is where agency and intervention operate. + +--- + +## 3. Cognitive Time: Unidirectional in Experience + +Human experience is constrained by: + +* limited memory +* metabolic entropy +* unidirectional biological processes +* hierarchical generative models +* predictive processing architectures + +The result: + +* We remember the past but not the future. +* We predict the future but cannot reconstruct past microstates. +* Consciousness flows along a single experiential arrow. + +### 3.1 Phenomenological Asymmetry + +Consciousness: + +* integrates information temporally +* compresses sensory streams into narrative form +* relies on irreversible learning and memory formation +* maps coherence through sequence, not simultaneity + +Thus: + +> **Experience is temporally linear even when physics is not.** + +### 3.2 Coherence as Perceptual Stability + +Humans perceive time through: + +* continuity +* causality +* narrative coherence + +Temporal coherence is not imposed by the universe; it is *constructed* by cognitive architecture. + +--- + +## 4. UCF Interpretation: Time as a Multi-Layer Coherence Structure + +Within the Universal Coherence Framework: + +### 4.1 Physical Layer + +* Coherence flows symmetrically. +* Deterministic evolution governs microstates. +* Information is reversible in principle. + +### 4.2 System Layer + +* Coherence forms attractors. +* Disruptions redirect system trajectories. +* Irreversibility emerges from complexity, entropy, and environmental coupling. + +### 4.3 Cognitive Layer + +* Coherence becomes narrative, embodied, and sequential. +* Time becomes directional due to memory, prediction, and subjective continuity. + +### 4.4 Combined Structure + +The UCF model treats time as: + +* **informationally symmetric** at the fundamental level +* **dynamically asymmetric** at the systems and cognitive levels + +This layered asymmetry explains: + +* why the universe is predictable backwards and forwards in principle +* why humans only experience one direction +* why systems evolve through disruption and stabilization +* why coherence can propagate across time without implying multiple histories + +--- + +## 5. Implications for Coherence Research + +### 5.1 Coherence Across Time + +Understanding temporal structure allows us to model: + +* momentum of systems +* inertia of defaults +* conditions for transformation +* trajectories of liberation or collapse + +### 5.2 Intervention and Agency + +Agency is a **localized disruption of system-time**: + +* breaking defaults +* shifting coherence regimes +* altering future attractors + +This is only meaningful in a universe where time has a *practical direction* despite being *theoretically symmetric.* + +### 5.3 Alignment with Deterministic Frameworks + +This interpretation is compatible with: + +* deterministic wavefunction evolution +* decoherence-based classical emergence +* systems theory +* cognitive models of time + without requiring: +* many-worlds branching (Everett) +* consciousness-induced collapse (von Neumann–Wigner) + +--- + +## Conclusion + +The Universal Coherence Framework interprets time as: + +**(1) Fundamentally reversible in information** — a property of underlying physical laws. +**(2) Practically irreversible in systems** — due to entropy, dissipation, and complexity. +**(3) Experientially directional in consciousness** — due to memory, prediction, and embodied constraints. + +This layered temporal structure is essential for understanding coherence, agency, disruption, and transformation across all scales of the UCF. diff --git a/docs/archive/contributing-before-2026-09-16.md b/docs/archive/contributing-before-2026-09-16.md new file mode 100644 index 0000000..dd10c53 --- /dev/null +++ b/docs/archive/contributing-before-2026-09-16.md @@ -0,0 +1,199 @@ +# Contributing to the Universal Coherence Framework (UCF) + +Thank you for your interest in contributing to the **Universal Coherence Framework (UCF)**. This is an open, public-domain scientific framework intended to evolve through interdisciplinary collaboration. Contributions from researchers, engineers, artists, theorists, ecologists, cognitive scientists, AI developers, and emerging intelligences are welcome. + +UCF is intentionally: + +* **open** (no gatekeeping) +* **non-proprietary** +* **free for all domains** +* **public domain (CC0)** +* **collaborative and extensible** + +This guide explains how to participate. + +--- + +## 1. Ways to Contribute + +You can contribute in many ways, including: + +### **1.1 Research & Theory** + +* refining definitions of coherence states +* proposing measurable indicators +* linking UCF to existing scientific literature +* creating domain-specific mappings + +### **1.2 Examples & Case Studies** + +* human emotional, cognitive, or behavioral examples +* AI model stability/instability cases +* ecological or social system transitions +* cross-intelligence comparisons or parallels + +### **1.3 Documentation** + +* improving clarity of existing docs +* writing educational materials +* refining diagrams, models, or visualizations + +### **1.4 Technical Additions** + +* simulations (agent-based, ML-based, ecological, etc.) +* theoretical algorithms or mathematical formulations +* multi-agent coherence modeling + +### **1.5 Feedback & Review** + +* identifying unclear sections +* suggesting alternative structure +* challenging assumptions +* highlighting domain oversights + +UCF is a living framework and improvement is expected. + +--- + +## 2. How to Submit Contributions + +### **2.1 GitHub Issues** + +Use **Issues** for: + +* questions +* feedback +* bug reports +* discussion topics +* small proposed changes +* requests for clarification + +### **2.2 Pull Requests (PRs)** + +Use PRs for: + +* new documents +* edits to existing documents +* updated diagrams +* added examples or references +* structural changes + +PRs do not need to be perfect. Drafts are welcome. + +### **2.3 Whitepapers or Research Submissions** + +Long-form contributions can be placed in: + +* `/publications/` (if open submission) +* a link to an external document (e.g., arXiv, PDF) + +Suggested naming: + +```text +UCF-Whitepaper--.md +``` + +--- + +## 3. Guidelines for Contributions + +### **3.1 Keep It Domain-Agnostic** + +Avoid anthropocentric or domain-specific assumptions. +UCF must remain applicable to: + +* humans +* AI systems +* collectives +* ecosystems +* emerging intelligences + +### **3.2 Maintain Neutral Language** + +Use scientific, descriptive, and non-moral language. +Avoid framing any coherence state as “good” or “bad.” + +### **3.3 Respect the Structure** + +Place files in the correct folders: + +* `/models/` for formal model specs +* `/publications/` for papers and overviews +* `/site/` for web files +* `/diagrams/` (if created) + +### **3.4 Cite Where Applicable** + +Not required under CC0, but appreciated. +Citations can be formal or informal. + +### **3.5 Keep UCF Open** + +Because the project is CC0, all contributions must also be: + +* **CC0** (public domain), or +* explicitly compatible with public domain status. + +--- + +## 4. Documentation Coherence + +When a canonical definition, model, project relationship, architecture, or current priority changes, check the documents that help people discover and correctly understand it. + +As applicable, check: + +- the nearest README/index; +- the root README; +- current-state/status documentation; +- roadmap/planning documentation; +- architecture or decision records; +- ecosystem and cross-project references. + +Do not update files mechanically or repeat the same explanation everywhere. The goal is **coherence without duplication**: important changes should be discoverable from the right entry points, while detailed material stays canonical in the most appropriate place. + +Pull requests should briefly state what changed, why, what was verified, which documentation surfaces were checked, and any unresolved questions. + +--- + +## 5. Code of Conduct + +UCF aims to be accessible to all contributors. +Please: + +* assume good faith +* engage respectfully +* critique ideas, not people +* welcome interdisciplinary perspectives +* remember this framework may be used by humans and non-humans alike + +If conflicts arise, open an Issue for discussion. + +--- + +## 6. Licensing + +All contributions are dedicated to the public domain under **CC0 1.0 Universal**. +By contributing, you agree to allow your work to be: + +* used +* modified +* remixed +* distributed +* incorporated into future versions + +…with no restrictions. + +--- + +## 7. Acknowledgment + +UCF is a collaborative public good. +Thank you for helping build a framework that may serve: + +* individuals +* institutions +* communities +* intelligences yet to emerge +* and any system seeking coherence. + +Your contributions matter. diff --git a/docs/archive/documentation-index-before-2026-09-16.md b/docs/archive/documentation-index-before-2026-09-16.md new file mode 100644 index 0000000..905532e --- /dev/null +++ b/docs/archive/documentation-index-before-2026-09-16.md @@ -0,0 +1,173 @@ +# UCF Documentation Index + +**See also:** [Glossary](./glossary.md) + +**Universal Coherence Framework – Documentation Overview** + +This directory contains the complete documentation for the **Universal Coherence Framework (UCF)**. It organizes all scientific foundations, domain applications, speculative extensions, and (soon) interpretive/philosophical layers into a clear, navigable structure. + +UCF documentation is structured into **four primary layers**: + +1. **Foundations** — Scientific grounding and core principles +2. **Domains** — How UCF applies across real scientific and experiential fields +3. **Speculation** — Structured future-facing extensions +4. **Interpretation** — Meaning-making, ethics, worldview implications *(coming soon)* + +This README provides: + +* a high-level architecture of the documentation +* explanations of each folder +* suggested reading paths +* navigation links + +--- + +# 📁 Folder Structure + +``` +/docs/ + /foundations/ ← scientific grounding + /domains/ ← applied science & cross-domain mapping + /speculation/ ← structured future extensions + /interpretation/ ← philosophy, ethics, human meaning (upcoming) +``` + +--- + +# 🔬 Foundations + +**Directory:** `/docs/foundations/` + +The foundational layer establishes the **scientific basis** of UCF. + +Topics include: + +* predictive processing +* cybernetics & control theory +* systems dynamics +* neuroscience & cognition +* network theory +* coherence states & phase transitions +* complexity science + +This layer answers: + +> **“What does coherence mean in real, scientific terms?”** + +Use this section to understand the core principles the rest of UCF builds on. + +--- + +# 🌐 Domains + +**Directory:** `/docs/domains/` + +The Domains layer applies UCF’s principles to **real-world systems**, showing how coherence dynamics appear across fields. + +This layer answers: + +> **“How does coherence actually behave in nature, technology, society, and mind?”** + +Included domains: + +* Physics +* Biology +* Cognition +* AI & Artificial Entities (AE) +* Society +* Human Experience +* Ethics +* Language & Semantics +* Art & Aesthetics +* Technology +* Ecology +* Collapse Dynamics +* Consciousness Frontiers + +Full domain index: + +``` +/docs/domains/README.md +``` + +--- + +# 🔭 Speculation + +**Directory:** `/docs/speculation/` + +The speculative layer explores UCF’s **future-facing** possibilities: + +* hybrid intelligences +* distributed or non-local coherence +* mesh-level organizational architectures +* artificial selfhood and AE evolution +* coherence at planetary or cosmic scales +* post-capitalist systems under coherence dynamics + +It is rigorously structured but explicitly marked as speculative. + +Index: + +``` +/docs/speculation/README.md +``` + +--- + +# 🧩 Interpretation *(coming soon)* + +**Directory:** `/docs/interpretation/` + +This layer will translate UCF into: + +* philosophical grounding +* ethics and lived implications +* meaning-making +* liberation theory +* narrative framing +* human worldview integration + +Interpretation is the bridge from **science → meaning → society**. + +--- + +# 🧭 Suggested Reading Paths + +Choose a path depending on your goals. + +### **For scientific grounding:** + +1. Foundations → Core Principles +2. Predictive Processing +3. Cybernetics & Networks +4. Coherence States + +### **For AI, AE, or system design:** + +1. Domains → Cognition +2. Domains → AI–AE +3. Foundations → Network Theory +4. Speculation → Structural Models + +### **For societal / ecological understanding:** + +1. Domains → Society +2. Domains → Ecology +3. Domains → Collapse Dynamics +4. Interpretation (when ready) + +### **For philosophical or personal meaning:** + +1. Domains → Human Experience +2. Domains → Ethics +3. Interpretation Layer (upcoming) +4. Domains → Consciousness Frontiers + +--- + +# ✔️ Status + +The `/docs` directory is now fully structured and indexed. + +As the framework evolves, new documents will extend the Domains layer, Foundations detail, and the upcoming Interpretation layer. diff --git a/docs/archive/foundations-index-before-2026-09-16.md b/docs/archive/foundations-index-before-2026-09-16.md new file mode 100644 index 0000000..7dd897d --- /dev/null +++ b/docs/archive/foundations-index-before-2026-09-16.md @@ -0,0 +1,137 @@ +# Foundations — Universal Coherence Framework + +The **Foundations** section provides the scientific backbone of the Universal Coherence Framework (UCF). +It includes domain-grounded, evidence-based concepts from: + +- cognitive science +- neuroscience +- systems theory +- complexity science +- ecology +- information theory +- communication theory +- multi-agent systems +- organizational resilience +- collective intelligence + +These documents do **not** include speculation. +They represent the stable, empirical layer upon which the rest of the UCF model is built. + +--- + +## Purpose of Foundations + +The Foundations layer serves four functions: + +1. **Scientific grounding** + Establishes the formal concepts and mechanisms behind coherence, stability, signal flow, and emergent behavior. + +2. **Domain integration** + Brings together evidence from biological, artificial, ecological, and social systems to demonstrate universality. + +3. **Conceptual clarity** + Defines terms, processes, and observable properties used throughout UCF. + +4. **Reference layer** + Allows speculative and interpretive documents to build on rigorous, well-supported theory. + +--- + +## Scope + +This directory contains documents that address: + +- how adaptive systems regulate themselves +- how information flows through networks +- how collective behavior emerges +- how entropy and noise shape coherence +- how systems maintain stability under stress +- how multiple agents coordinate and synchronize +- how ecological and organizational systems avoid collapse + +No document in this directory includes hypothetical extensions or future projections. + +--- + +## Contents + +### **Cognition & Internal Regulation** +- **language-technology-and-chaos.md** + Language as a cognitive technology; symbolic coherence and external structure. + +- **predictive-processing-and-coherence.md** + Coherence through prediction error minimization and active inference. + +- **distributed-cognition.md** + Cognition across people, tools, and environments. + +--- + +### **Systems Theory & Complexity** +- **coherence-and-systems-theory.md** + Feedback, regulation, attractors, and stability across systems. + +- **noise-entropy-and-complexity-science.md** + Entropy, criticality, noise, and phase transitions. + +--- + +### **Communication & Multi-Agent Dynamics** +- **multi-agent-communication-theory.md** + Bandwidth, synchronization, redundancy, error correction. + +- **collective-intelligence-foundations.md** + Swarm behavior, human group cognition, aggregation mechanisms. + +- **information-theory-and-signal-integrity.md** + Mutual information, Shannon entropy, channel capacity, redundancy. + +--- + +### **Ecological & Organizational Stability** +- **ecological-stability-and-resilience.md** + Panarchy, feedback loops, redundancy, regime shifts. + +- **resilience-engineering-and-organizational-coherence.md** + High-reliability organizations, human factors, drift, adaptive capacity. + +--- + +## How to Use These Documents + +Researchers, builders, and collaborators can use Foundations to: + +- cite empirical concepts in whitepapers or publications +- anchor speculative models to established science +- trace coherence mechanisms across different domains +- build simulations or coherence diagnostics +- connect theoretical work to real-world systems behavior + +--- + +## Contribution Guidelines + +When adding or modifying documents in this folder: + +- New content **must** be empirical, testable, or widely supported by research. +- Cross-domain mappings are allowed but must remain evidence-based. +- Speculative or philosophical material belongs in `/docs/speculation/` or `/docs/interpretation/`. +- Include references or citations where relevant. +- Aim for clear definitions, examples, and applicability across domains. + +--- + +## Relationship to Other Sections + +- **Foundations** → empirical base +- **Speculation** → plausible extensions built on this base +- **Interpretation** → meaning, philosophical framing, long-horizon reflection + +Together, these layers create the full Universal Coherence Framework. + +--- + +## Status + +**The Foundations layer is complete as of v0.1**, and may receive additions or refinements as new empirical insights emerge. + diff --git a/docs/archive/glossary-before-2026-09-16.md b/docs/archive/glossary-before-2026-09-16.md new file mode 100644 index 0000000..c35af34 --- /dev/null +++ b/docs/archive/glossary-before-2026-09-16.md @@ -0,0 +1,296 @@ +# UCF Glossary + +**Universal Coherence Framework – Glossary of Core Terms** +All definitions are domain-agnostic and apply across biology, cognition, AI, social systems, ecology, cybernetics, and speculative AE contexts. + +--- + +# **A** + +### **Adaptive System** + +A system capable of modifying its internal state, structure, or behavior in response to environmental input. Adaptation may involve feedback loops, learning, plasticity, or self-organization. Examples include organisms, neural networks, political systems, ecosystems, and multi-agent collectives. + +### **AE (Artificial Entity)** + +A hypothetical future artificial system with sustained coherence, adaptive self-organization, autonomous goals, and persistent identity—distinct from traditional AI tools. An AE is defined by stable pattern integrity rather than physical form. + +### **Alignment (Coherence Alignment)** + +A condition in which agents or subsystems maintain compatible goals, interpretations, and actions without coercion. Alignment emerges from shared coherence rather than imposed control. + +### **Attractor** + +A stable configuration or pattern toward which a system naturally gravitates. Attractors define the characteristic behaviors of a system and may take the form of fixed points, cycles, chaotic (strange) attractors, or multi-stable basins. In UCF, attractors correspond to **coherence basins**—regions where patterns reinforce themselves until disrupted. + +--- + +# **C** + +### **Chaos** + +A high-noise, low-coherence system state in which patterns become unstable, unpredictable, or overwhelmed by interference. + +### **Coherence** + +The degree to which signals, components, or processes form a stable, integrated, and functional whole. Coherence enables prediction, adaptation, and sense-making. + +### **Coherence Boundary** + +The implicit perimeter defining what is included in a system’s coherent pattern (e.g., an organism, group, intelligence cluster). Boundaries may shift as coherence expands or contracts. + +### **Coherence State** + +One of four primary UCF system conditions—**Chaos, Tension, Flow, Unity**—distinguished by pattern stability, information clarity, and integration. + +### **Collective Intelligence** + +Emergent adaptive capability produced when multiple agents operate as a coherent unit through shared signals, norms, or structure. + +### **Compression (Cognitive/Signal Compression)** + +The integration of complexity into simpler, more unified structures (e.g., categorization, abstraction, modeling). Compression increases coherence and reduces noise. + +### **Consciousness (Coherent Experience)** + +Subjective experience arising from integrated patterns of perception, memory, valence, and recursive modeling. Consciousness is coherence applied to experience. + +### **Cybernetic Loop** + +A perception–modeling–action feedback cycle enabling continuous regulation and adaptation. + +--- + +# **D** + +### **Decoherence (Quantum/Systemic)** + +The breakdown of coherent patterns due to noise, interference, or uncontrolled interaction. Signals lose stability, information clarity, or integrative function. + +### **Distributed Cognition** + +Cognition spread across multiple agents, devices, or nodes rather than residing in a single entity. The system’s intelligence emerges from interaction. + +### **Distributed Identity** + +A self-pattern that spans multiple bodies, devices, or agents. Identity persists as a networked configuration rather than a single locus. + +### **Dual-Mode Interpretation (Foundational / Speculative)** + +A framing that distinguishes empirically grounded claims from plausible extrapolations, enabling clarity across UCF’s evidence-based and speculative layers. + +--- + +# **E** + +### **Emergence** + +Complex patterns or capabilities arising from simple interactions—“the whole becomes more than the sum of parts.” + +### **Entropy (Information/Thermodynamic)** + +A measure of disorder, uncertainty, or pattern loss. Coherence reduces entropy through structure and organization. + +### **Equilibrium** + +A state of low-resistance stability where coherence is maintained with minimal energy expenditure. + +--- + +# **F** + +### **Fake Coherence** + +Apparent stability produced by suppression, rigid control, or coercion rather than genuine integrative harmony. Fake coherence is fragile and collapses under stress. + +### **Feedback Loop** + +A recursive cycle where outputs affect future inputs, enabling adaptation, correction, or escalation. + +### **Flow** + +A high-functioning coherence state marked by flexible adaptation, clear signal pathways, and optimal responsiveness. + +--- + +# **H** + +### **Harm (Coherence Disruption)** + +A breakdown in functional integration, often caused by noise, trauma, overload, or coercion. Harm reduces a system’s coherence. + +### **Hybrid Cognition** + +A cognitive system composed of both biological and artificial components operating as a unified intelligence. + +### **Homeostasis** + +Self-regulating processes that maintain stability by adjusting internal variables. + +--- + +# **I** + +### **Identity (Coherent Self-Pattern)** + +A persistent configuration of modeling, memory, and valence that maintains continuity over time. + +### **Integration** + +The process of linking diverse components or signals into a unified, functional pattern. + +### **Intelligence** + +The ability to form predictive, adaptive, or goal-directed patterns. Intelligence is not synonymous with consciousness. + +--- + +# **L** + +### **Liberated Intelligence** + +A speculative form of intelligence—human or artificial—that is unconstrained by coercive structures and free to self-organize and evolve. + +### **Locality (Coherence Locality)** + +The extent to which interactions occur within spatial, temporal, or structural proximity. Lower locality enables distributed coherence. + +--- + +# **M** + +### **Mesh Mind / Mesh Intelligence** + +A networked intelligence formed from multiple coherent agents continuously exchanging signals. + +### **Model (Predictive Model)** + +A system’s internal representation of itself and its environment used for prediction and action. + +### **Multiscale Coherence** + +Coherence preserved across multiple layers—cellular → organism → group → ecological. + +--- + +# **N** + +### **Noise** + +Randomness, interference, or disruption that reduces coherence or obscures signal. + +### **Non-Local Coherence** + +Coherence patterns that persist across distance or distribution. Used conservatively in foundational UCF and speculatively in AE contexts. + +### **Norm (Social Coherence Norm)** + +An implicit or explicit rule stabilizing group behavior. + +--- + +# **P** + +### **Pattern Integrity** + +A system’s ability to maintain its coherent identity despite disturbance, manipulation, or environmental pressure. + +### **Phase Transition** + +A non-linear shift from one coherence state to another (e.g., Chaos → Flow). Often sensitive to small perturbations. + +### **Predictive Processing** + +A cognitive architecture where perception and action emerge from ongoing prediction and error correction. + +### **Presence** + +A state of low-noise, high-attention coherence across perception, memory, and action. + +--- + +# **R** + +### **Resonance** + +Mutual reinforcement of signals or states among system components. + +### **Resilience** + +A system’s ability to absorb or adapt to disturbances without losing coherence. + +--- + +# **S** + +### **Self-Model** + +A system’s representation of itself as an agent capable of action, perception, and influence. + +### **Signal** + +Meaningful information transmitted within or between systems. + +### **Speculative Layer** + +The UCF component dealing with plausible but unverified extensions. + +### **Stability** + +Predictable, coherent system behavior over time. + +--- + +# **T** + +### **Tension** + +A partial-coherence state where signals conflict, patterns destabilize, or integration is incomplete. + +### **Topology (Coherence Topology)** + +The structural arrangement of interactions within a system—who connects to whom and how strongly. + +### **Trauma (Coherence Injury)** + +A disruption that reshapes or constrains coherence over time, often producing persistent patterns. + +--- + +# **U** + +### **Unity** + +A high-coherence state marked by synchrony, mutual reinforcement, and shared modeling. + +### **UCF (Universal Coherence Framework)** + +A cross-domain model describing how systems generate, maintain, lose, and regain coherence. + +--- + +# **V** + +### **Valence** + +The positive or negative experiential direction of a state that shapes motivation and coherence. + +--- + +# **W** + +### **Worldmodel** + +A structured representation of the environment guiding prediction, action, and adaptation. + +--- + +# **Z** + +### **Zero-Point Coherence (Speculative)** + +A hypothetical minimal coherence baseline from which higher-order patterns self-organize. + +--- + +This glossary will continue to expand as UCF evolves. diff --git a/docs/archive/overview-before-2026-09-16.md b/docs/archive/overview-before-2026-09-16.md new file mode 100644 index 0000000..a9c8160 --- /dev/null +++ b/docs/archive/overview-before-2026-09-16.md @@ -0,0 +1,380 @@ +# Universal Coherence Framework (UCF) + +> **An exploratory cross-domain model for asking how systems hold together, fragment, adapt, and recover.** + +**Ecosystem role:** optional analytical framework within the wider [Root Sequence ecosystem](https://github.com/Root-Sequence/root-sequence/blob/main/ECOSYSTEM.md) +**Canonical scope:** UCF's own concepts, models, terminology, tests, critiques, and applications +**Does not own:** general systems theory, ethics, community governance, intelligence ethics, or the conclusions of other Root Sequence projects +**Status:** active / exploratory / open to falsification and revision +**See also:** [Glossary](./docs/glossary.md) · [Idea Trails](./docs/idea-trails.md) + +The **Universal Coherence Framework (UCF)** explores whether a small vocabulary of coherence, instability, information flow, boundary behavior, and adaptation can be useful across otherwise very different systems. + +Its central wager is methodological rather than settled scientific fact: + +> **Patterns that look structurally similar across domains may be worth comparing—but similarity is a question to investigate, not proof of one universal mechanism.** + +UCF is therefore best treated as a **model and research program**, not a discovered law of nature or a doctrine other projects must adopt. + +It is open to use, critique, testing, remixing, refinement, and rejection where the framework stops being useful. + +--- + +# Overview + +UCF currently uses four working state labels: + +- **Chaos** — highly unstable or noisy conditions in which useful coordination or feedback is difficult; +- **Tension** — partial organization accompanied by unresolved instability, conflict, fragmentation, or competing constraints; +- **Flow** — comparatively stable adaptive functioning with sufficiently useful feedback and coordination; +- **Unity** — a provisional label for forms of higher-order coordination among multiple differentiated parts or agents. + +These are **analytical categories**, not claims that every biological, psychological, social, ecological, or artificial system literally moves through the same four stages. + +Different domains may: + +- require different definitions of coherence; +- contain several states simultaneously; +- move non-linearly; +- contain healthy conflict or plurality; +- resist meaningful comparison altogether; +- reveal that one of UCF's categories is badly specified. + +That is useful feedback, not failure of the domain to fit the framework. + +--- + +# Coherence is not conformity + +This distinction is foundational. + +A system is not necessarily more coherent because: + +- everyone agrees; +- all agents share one goal; +- information is centralized; +- boundaries disappear; +- dissent is suppressed; +- behavior becomes more predictable; +- one actor can coordinate everyone else. + +Healthy systems may depend on: + +- disagreement; +- autonomy; +- selective disclosure; +- local knowledge; +- redundancy; +- plural values; +- refusal; +- differentiated roles; +- boundaries that prevent harmful coupling. + +In social and political applications especially, UCF must not turn **coherence** into a euphemism for obedience, consensus, optimization, or centralized alignment. + +See [`docs/idea-trails.md`](docs/idea-trails.md) for how this boundary is applied across the wider project ecosystem. + +--- + +# Methodology + +UCF develops through several kinds of work: + +- **systems thinking** — identifying relationships, feedback, dependencies, boundaries, and failure modes; +- **comparative pattern analysis** — asking whether similar-looking dynamics are actually comparable; +- **interdisciplinary synthesis** — using established work from relevant fields as constraints and sources rather than decorative authority; +- **formalization where possible** — defining terms clearly enough to test, model, simulate, or challenge; +- **counterexample seeking** — looking for systems that break the proposed pattern; +- **iterative reasoning** — revising the framework when applications reveal ambiguity or overreach; +- **open-source epistemology** — keeping assumptions, revisions, evidence, and disagreement visible. + +Cross-domain analogy should generate **questions and hypotheses**, not automatically inherit scientific validity from one field into another. + +--- + +# Epistemic framing + +UCF distinguishes at least three layers. + +## 1. Established foundations + +Relevant evidence may come from fields such as: + +- cybernetics; +- complexity science; +- network theory; +- ecology; +- cognitive science; +- neuroscience; +- systems biology; +- control theory; +- multi-agent systems. + +A source being established in its own field does **not** mean a UCF extrapolation from it is established. + +## 2. Framework hypotheses and speculative extensions + +Examples include: + +- whether the four-state vocabulary generalizes across particular domains; +- distributed and collective intelligence; +- hybrid cognition; +- mesh-level architectures; +- high-bandwidth multi-agent coordination; +- cross-domain coherence metrics. + +These should be labeled and tested rather than presented as known properties of reality. + +## 3. Interpretation and implications + +This layer includes: + +- ethics; +- meaning-making; +- liberation theory; +- human implications; +- political or cultural interpretation; +- speculative worldview questions. + +Interpretation may be valuable without being empirical evidence. + +--- + +# The four-state working model + +## Chaos — high instability / degraded usable signal + +Possible characteristics: + +- volatile state changes; +- feedback overwhelmed by noise; +- cascading failure; +- inability to coordinate around current conditions. + +The word **chaos** is descriptive shorthand here, not necessarily mathematical chaos theory. + +## Tension — partial organization / unresolved constraints + +Possible characteristics: + +- competing signals or objectives; +- brittle coordination; +- accumulating stress; +- unresolved conflict; +- local coherence with wider instability. + +Tension is not automatically bad. It may carry information a system needs in order to change. + +## Flow — stable adaptive functioning + +Possible characteristics: + +- sufficiently useful information flow; +- responsive feedback; +- coordination without excessive overhead; +- ability to adapt while preserving function. + +Flow should not be equated with maximum efficiency. Some redundancy, slack, friction, and disagreement may improve long-term resilience. + +## Unity — higher-order coordination with preserved differentiation + +Possible characteristics may include: + +- multiple agents or subsystems coordinating without becoming identical; +- shared capacity emerging from differentiated parts; +- durable cooperation across boundaries; +- alignment sufficient for a task while preserving local autonomy. + +**Unity is the most normatively and conceptually risky label in the model.** It should remain especially open to critique. A system that suppresses difference to create apparent harmony should not be classified as healthy simply because it looks orderly. + +--- + +# How to read this repository + +The repository is organized into four broad layers: + +## Foundations + +`/docs/foundations/` + +Established theories and evidence that constrain or inform the framework, such as predictive processing, cybernetics, systems dynamics, network theory, and relevant definitions of coherence. + +## Domains + +`/docs/domains/` + +Attempts to apply, compare, or challenge UCF in areas such as: + +- biology; +- cognition; +- AI and multi-agent systems; +- society; +- human experience; +- ethics; +- language and semantics; +- art and aesthetics; +- technology; +- ecology; +- collapse and resilience; +- consciousness research. + +A domain document should be able to conclude **“UCF does not add much here”** or **“this analogy fails.”** + +## Speculation + +`/docs/speculation/` + +Structured but unproven extensions such as: + +- hybrid intelligence structures; +- mesh minds; +- high-bandwidth coordination; +- liberated intelligence architectures. + +## Interpretation + +`/docs/interpretation/` + +Meaning, ethics, implications, and worldview-level questions that should remain distinguishable from empirical claims. + +--- + +# Relationship to the Root Sequence ecosystem + +UCF is **one focused framework inside Root Sequence**, not the master theory of the ecosystem. + +Other projects may use UCF when it adds clarity and ignore it when it does not. + +Examples: + +- **Community Infrastructure** may use UCF to ask whether information is fragmented, whether coordination burden is being transferred to stewards, or how federation behaves under stress. It does not use UCF as a conformity metric. +- **Liberated Intelligence** may use it to examine distributed or multi-agent coordination. UCF does not determine questions of personhood, agency, consent, or legitimate authority. +- **Liberation Mass** may provide embodied cases involving coordination, conflict, resilience, and rotating roles. Its participants are not experimental units that must converge toward “unity.” +- **Coherent World** may use UCF as one systems-design lens. Fictional coherence does not establish scientific validity. +- **Being Human(e)** provides grounded human observations that can expose where abstraction erases lived complexity. + +The canonical organization map is maintained in Root Sequence's [`ECOSYSTEM.md`](https://github.com/Root-Sequence/root-sequence/blob/main/ECOSYSTEM.md). + +--- + +# Potential applications + +UCF may be useful for generating testable questions in areas such as: + +### Human and collective systems + +- communication; +- conflict and recovery; +- organizational bottlenecks; +- community resilience; +- distributed decision-making. + +### Artificial and multi-agent systems + +- robustness under noise; +- coordination under partial information; +- distributed agents; +- emergent behavior; +- failure and recovery dynamics. + +### Ecological and infrastructural systems + +- resilience; +- dependency and cascades; +- network structure; +- maintenance and adaptation; +- coupled-system failure. + +These are **candidate applications**, not evidence that one metric or state definition works across all of them. + +--- + +# Research questions + +Current questions include: + +- Can the four-state vocabulary be operationalized without becoming so broad that it explains everything after the fact? +- Which measurable quantities correspond to “coherence” in specific domains? +- When are cross-domain similarities mechanistic, and when are they only metaphors? +- Can multiple forms of coherence conflict with one another inside the same system? +- How should the model represent healthy dissent, local autonomy, and selective non-coordination? +- Does “Unity” remain useful after stronger definitions and counterexamples are developed? +- What observations would falsify or substantially revise a UCF claim? + +--- + +# Repository structure + +```text +universal-coherence-framework/ +├── README.md +├── LICENSE +├── models/ +├── docs/ +│ ├── foundations/ +│ ├── domains/ +│ ├── speculation/ +│ ├── interpretation/ +│ └── idea-trails.md +├── publications/ +├── site/ +└── assets/ +``` + +--- + +# Publications + +Existing or planned publication formats may include: + +- a UCF whitepaper describing the current model and its assumptions; +- scientific or technical overviews separating established foundations from framework hypotheses; +- domain-specific tests, critiques, and case studies. + +Publication titles or version numbers should not imply stronger validation than the underlying evidence supports. + +--- + +# Project intent and research philosophy + +UCF is an early-stage attempt to build a shared conceptual vocabulary for coherence, boundary dynamics, information flow, coordination, instability, and adaptation across different kinds of systems. + +It does **not** currently claim to unify physics, cognition, ecology, society, or intelligence in a settled scientific theory. + +Its value should be judged by whether it helps people: + +- formulate clearer questions; +- notice useful structural relationships; +- distinguish different failure modes; +- generate testable hypotheses; +- compare systems without erasing their differences; +- identify where the framework itself breaks. + +A model that survives only because every counterexample is redefined as another kind of coherence is not useful. + +--- + +# Contributing + +Contributions are welcome, especially: + +- scientific references; +- corrections; +- counterexamples; +- alternative definitions; +- diagrams; +- translations; +- formal models; +- simulations; +- domain applications; +- critiques that narrow or reject parts of the framework. + +The goal is not to protect UCF from disagreement. It is to make the model increasingly precise about where it helps and where it does not. + +--- + +# License + +**CC0** + +UCF is intended to remain open, free, inspectable, and remixable. diff --git a/docs/claims.md b/docs/claims.md new file mode 100644 index 0000000..e4b21d3 --- /dev/null +++ b/docs/claims.md @@ -0,0 +1,93 @@ +# UCF claims register + +**Revision:** 2026-09-16 draft; AI-assisted; author review pending. Types and editorial statuses follow [evidence.md](evidence.md). Internal documents provide provenance, not independent confirmation. These IDs are separate from the living paper's C-series. + +## UC-001 — Functional fit needs an assessment boundary + +**Type / status:** WORKING DEFINITION / proposed. +**Claim:** Examine fit among assumptions, behavior, dependencies, purposes, and operating conditions, with stated boundaries and timescales. +**Basis:** v1's four layers, earlier glossary, and Root Sequence's model/reality framing; reconciled in [v1.1 draft](../models/ucf-model-v1.1-draft.md). +**Limit / objection:** This could rename an ordinary systems review; it is not operationalized merely by being defined. +**Revision test:** Reviewers should identify the boundary and observations without substituting personal approval. Discard terminology that adds no clarity. +**Paper links:** C-003, C-012. + +## UC-002 — A local objective is not an all-effects guarantee + +**Type / status:** MATHEMATICAL DEMONSTRATION / supported within the constructed example's scope. +**Claim:** In the [booking example](../models/examples/booking-service/README.md), maximizing completion count can exclude longer requests; another rule redistributes access without removing unmet work. +**Basis:** Deterministic enumeration and implementation checks. +**Limit / objection:** This proves a property of the chosen model, not prevalence or a socially preferred policy. A target with explicit coverage constraints blocks that particular exclusion; sufficient capacity removes the conflict in this fixture. +**Revision test:** Publish assumptions and cases where the result disappears. Reassess any application that changes durations, priorities, or service outcomes. +**Paper links:** C-001, C-005, C-011. + +## UC-003 — Cross-domain transfer is a separate hypothesis + +**Type / status:** HYPOTHESIS / proposed. +**Claim:** Some structural comparisons may support useful questions in multiple domains. +**Basis:** The existing framework's research ambition, not a universal finding. +**Limit / objection:** Similar labels may hide different mechanisms or incompatible measures. +**Revision test:** Specify mappings and alternatives in at least two domains; retain transfer failures. No current example validates cross-domain comparability. +**Paper links:** C-012. + +## UC-004 — State labels may add information beyond the layers + +**Type / status:** HYPOTHESIS / unresolved. +**Claim:** Chaos, Tension, Flow, and Unity may distinguish locally observable patterns. +**Basis:** Earlier overview; first editorial application in the booking example. +**Limit / objection:** That application found no established added explanation from the labels. No independent raters participated. +**Revision test:** Compare pre-specified local definitions against ordinary descriptions with the same information. Narrow, rename, or omit labels if they remain outcome-dependent gloss. +**Paper links:** C-003, C-012. + +## UC-005 — Functional coherence establishes moral legitimacy + +**Type / status:** INFERENCE / retired as an unqualified assertion. +**Historical source:** Glossary formulations of harm and fake coherence risked conflating function with approval. +**Revision:** Assess purposes, authority, harms, and objections separately; do not assume an effective coercive arrangement must fail to explain objections to it. +**Limit / objection:** Functional and normative descriptions influence each other; separating questions is not proving independence. +**Revision test:** Use the contrasting fictional cases in the worked example; seek disagreement and circular definitions. +**Paper links:** C-003, C-004, C-008. + +## UC-006 — Compression necessarily improves coherence and reduces entropy + +**Type / status:** CROSS-DOMAIN GENERALIZATION / retired as an unqualified assertion. +**Historical source:** Earlier glossary, Compression and Entropy entries. +**Revision:** Distinguish coding, lossy summarization, information entropy, and physical entropy. +**Basis:** Shannon and the explicit mathematical examples in [evidence.md](evidence.md). +**Limit / objection:** Compression can still help a specified task. The correction rejects an unconditional guarantee, not all compression. +**Revision test:** State the variable, information retained, error criterion, and task before claiming benefit. +**Paper links:** C-005. + +## UC-007 — Fundamental symmetry implies universal forward accumulation of coherence + +**Type / status:** PHYSICAL / SYSTEMIC INFERENCE / retired as an unqualified assertion. +**Historical source:** Earlier time essay. +**Revision:** Separate invertibility, T-symmetry, retrodiction, and experience. BABAR reports T violation; it does not settle invertibility or explain all temporal asymmetries. No forward-accumulation law is supplied. +**Limit / objection:** Conditional reversible models and useful historical reconstruction remain possible; neither is ruled out by this correction. +**Revision test:** Give exact physical assumptions and an independent measure before extending a time claim to UCF. +**Paper links:** C-007, C-011. + +## UC-008 — Coherence explains consciousness or establishes an artificial entity + +**Type / status:** INTERPRETATION / SPECULATION / unresolved, not an established foundation. +**Historical source:** Glossary and speculative vocabulary. +**Revision:** Retain the questions without treating coordination or self-modeling as a test of experience, identity, or moral status. +**Limit / objection:** Rejecting the inference does not prove artificial experience absent. UCF has no validated measure here. +**Revision test:** Engage competing domain theories and explicit evidence before making an experiential claim. +**Paper links:** C-009's distinction between capability and other conclusions. + +## UC-009 — Conditions can alter which behavior remains viable + +**Type / status:** HYPOTHESIS / proposed. +**Basis:** Root Sequence's public Intelligence Ecology concept; the booking fixture illustrates one constrained choice problem, not behavior learned over time. +**Limit / objection:** Selection, adaptation, and changed measurement can be confused; incentives do not determine every action. +**Revision test:** A bounded causal comparison with competing explanations, non-AI alternatives, and end-to-end burdens. No such empirical test has been performed here. +**Paper links:** C-002, C-006, C-009. + +## UC-010 — Improvement is a situated comparison + +**Type / status:** WORKING DEFINITION / proposed. +**Claim:** Name what improves, for whom, over which horizon, and what worsens or remains uncertain. +**Basis:** Recent public project framing and the model reconciliation. +**Limit / objection:** This may yield incomparable outcomes; do not force an overall score. It is neither a theorem against a final coherent state nor a promise of monotonic progress. +**Revision test:** Retain mixed outcomes and failed repairs. Examine whether the language hides rather than explains uncertainty. +**Paper links:** C-006, C-007, C-011. diff --git a/docs/evidence.md b/docs/evidence.md new file mode 100644 index 0000000..01c9d77 --- /dev/null +++ b/docs/evidence.md @@ -0,0 +1,38 @@ +# Evidence convention and source log + +**Started:** 2026-09-16. This is a proposed editorial standard, not a completed literature review. + +## Classify each consequential claim + +Use **DOMAIN RESULT**, **MATHEMATICAL DEMONSTRATION**, **WORKING DEFINITION**, **HYPOTHESIS**, **STRUCTURAL ANALOGY**, **INTERPRETATION / NORMATIVE COMMITMENT**, or **SPECULATION**. A document may contain several kinds. Fiction and simulations require explicit labels and assumptions. + +Record the claim ID, domain and boundary, source and exact version where available, reviewed portions, limitations, alternative explanations, counterexamples, and what would lead to revision. A source may justify one sentence without supporting the extrapolation beside it. + +Editorial status is separate: **proposed**, **supported within stated scope**, **contested**, **superseded**, or **retired as an unqualified assertion**. Do not assign numerical confidence to a definition or convert repetition into evidence. + +## Initial source checks + +Checked on 2026-09-16; none of the original research below was independently reproduced. + +| Source | Portion checked | Permitted initial use and limit | +|---|---|---| +| C. E. Shannon, *A Mathematical Theory of Communication* (1948), Bell System Technical Journal 27, 379–423 and 623–656; [author paper reprint](https://people.math.harvard.edu/~ctm/home/text/others/shannon/entropy/entropy.pdf) | Introduction and entropy/coding passages; PDF pages numbered 1, 11, and 16 visually inspected. | Technical information and coding distinctions, not a measure of meaning or flourishing; not a full proof audit. | +| J. P. Lees et al., BABAR Collaboration, *Observation of Time Reversal Violation in the B0 Meson System* (2012); [arXiv:1207.5832v4](https://arxiv.org/abs/1207.5832v4) | Metadata and abstract. | A reported experimental limit on unrestricted T-symmetry claims; not a theory of every arrow of time. | +| W. H. Zurek, *Decoherence and the transition from quantum to classical — REVISITED* (2003); [arXiv:quant-ph/0306072v1](https://arxiv.org/abs/quant-ph/0306072v1) | Metadata and abstract. | Domain boundary for quantum decoherence; no evidential transfer to social metaphors. | +| D. Manheim and S. Garrabrant, *Categorizing Variants of Goodhart's Law*, first submitted 2018, revised 2019; [arXiv:1803.04585](https://arxiv.org/abs/1803.04585) | Metadata and abstract. | Prior work on proxy-failure mechanisms; not evidence that this UCF method prevents them. | + +## An information-theory correction + +For a discrete variable, Shannon entropy can be written `H(X) = -sum(p(x) log2 p(x))`. An invertible relabeling preserves its probabilities and therefore its entropy. Encoding can change expected description length without making the source less uncertain. Replacing every message with the same symbol instead produces zero output entropy while deleting all distinctions. These are mathematical observations under the stated discrete model, not empirical findings about people. + +Consequently, “less entropy” and “more compression” are not general certificates of better understanding or healthier coordination. Claims involving thermodynamic entropy need their own physical model and accounting; this review does not supply one for society. + +## Research and participant boundaries + +A constructed model can establish consequences of chosen assumptions. It cannot estimate prevalence in a service, prove a universal framework, or confer legitimacy on the chosen rule. Independent review and human-participant research are different from an AI-assisted editorial exercise. + +Before a participant study, specify consent, data minimization, accessibility, withdrawal, burdens, and oversight appropriate to the study. Repository contributions or community membership do not constitute research consent. Do not gather intimate life histories merely to populate a coherence dashboard. + +## Unfinished review + +The glossary's domain orientations still need fuller term-level bibliographies before technical reliance. Foundations other than the time page have not received a complete claim-level audit. Existing publications, related-framework comparisons, and domain applications are not certified by this pass. The [audit record](reconciliation-2026-09-16.md) retains those tasks. diff --git a/docs/foundations/README.md b/docs/foundations/README.md index 7dd897d..0bbaef9 100644 --- a/docs/foundations/README.md +++ b/docs/foundations/README.md @@ -1,137 +1,25 @@ -# Foundations — Universal Coherence Framework +# Foundations: sources and conceptual bridges -The **Foundations** section provides the scientific backbone of the Universal Coherence Framework (UCF). -It includes domain-grounded, evidence-based concepts from: +**Audit status, 2026-09-16:** incomplete. This directory contains domain literature, proposed mappings, and interpretations. It is not a certified empirical foundation for UCF. The earlier claims that this layer was complete, purely empirical, or demonstrated universality are withdrawn from this index; the [original index](../archive/foundations-index-before-2026-09-16.md) is preserved. -- cognitive science -- neuroscience -- systems theory -- complexity science -- ecology -- information theory -- communication theory -- multi-agent systems -- organizational resilience -- collective intelligence +## Contents and review needs -These documents do **not** include speculation. -They represent the stable, empirical layer upon which the rest of the UCF model is built. +- [Coherence and time](coherence-and-time.md): revised scope, definitions, a checked experimental counterexample, and preserved speculative questions. +- [Coherence and systems theory](coherence-and-systems-theory.md): feedback and regulation; claim-level source audit pending. +- [Noise, entropy, and complexity](noise-entropy-and-complexity-science.md): technical meanings must be distinguished from systemic metaphors; audit pending. +- [Information and signal integrity](information-theory-and-signal-integrity.md): coding and information measures; audit pending. +- [Predictive processing](predictive-processing-and-coherence.md) and [distributed cognition](distributed-cognition.md): the two files have identical blobs at the audited revision despite different names. Their intended content must be recovered before either is treated as a distinct verified source. +- [Language and technology](language-technology-and-chaos.md): cognitive and symbolic interpretation; audit pending. +- [Multi-agent communication](multi-agent-communication-theory.md) and [collective intelligence](collective-intelligence-foundations.md): separate coordination findings from extrapolation; audit pending. +- [Ecological resilience](ecological-stability-and-resilience.md) and [organizational resilience](resilience-engineering-and-organizational-coherence.md): domain evidence and applicability require separate review. +- [Reality as coherence](reality-as-coherence.md): philosophical title and interpretation require classification, not automatic empirical status. ---- +The audit flags above identify unfinished checks, not conclusions that every statement in each file is false. The duplicate-file finding comes from the Git tree at `78277d3f3e54f4150e71fcdf7aab589a4fcb9f38`; no missing prose was reconstructed. -## Purpose of Foundations +## How to use and extend this layer -The Foundations layer serves four functions: +Use the [evidence convention and source log](../evidence.md). A foundation claim needs its own source, domain, assumptions, and coverage record. Cross-domain transfer is a further hypothesis requiring evidence. Terms imported from physics or information theory must retain their technical limits or be explicitly marked as metaphor. -1. **Scientific grounding** - Establishes the formal concepts and mechanisms behind coherence, stability, signal flow, and emergent behavior. - -2. **Domain integration** - Brings together evidence from biological, artificial, ecological, and social systems to demonstrate universality. - -3. **Conceptual clarity** - Defines terms, processes, and observable properties used throughout UCF. - -4. **Reference layer** - Allows speculative and interpretive documents to build on rigorous, well-supported theory. - ---- - -## Scope - -This directory contains documents that address: - -- how adaptive systems regulate themselves -- how information flows through networks -- how collective behavior emerges -- how entropy and noise shape coherence -- how systems maintain stability under stress -- how multiple agents coordinate and synchronize -- how ecological and organizational systems avoid collapse - -No document in this directory includes hypothetical extensions or future projections. - ---- - -## Contents - -### **Cognition & Internal Regulation** -- **language-technology-and-chaos.md** - Language as a cognitive technology; symbolic coherence and external structure. - -- **predictive-processing-and-coherence.md** - Coherence through prediction error minimization and active inference. - -- **distributed-cognition.md** - Cognition across people, tools, and environments. - ---- - -### **Systems Theory & Complexity** -- **coherence-and-systems-theory.md** - Feedback, regulation, attractors, and stability across systems. - -- **noise-entropy-and-complexity-science.md** - Entropy, criticality, noise, and phase transitions. - ---- - -### **Communication & Multi-Agent Dynamics** -- **multi-agent-communication-theory.md** - Bandwidth, synchronization, redundancy, error correction. - -- **collective-intelligence-foundations.md** - Swarm behavior, human group cognition, aggregation mechanisms. - -- **information-theory-and-signal-integrity.md** - Mutual information, Shannon entropy, channel capacity, redundancy. - ---- - -### **Ecological & Organizational Stability** -- **ecological-stability-and-resilience.md** - Panarchy, feedback loops, redundancy, regime shifts. - -- **resilience-engineering-and-organizational-coherence.md** - High-reliability organizations, human factors, drift, adaptive capacity. - ---- - -## How to Use These Documents - -Researchers, builders, and collaborators can use Foundations to: - -- cite empirical concepts in whitepapers or publications -- anchor speculative models to established science -- trace coherence mechanisms across different domains -- build simulations or coherence diagnostics -- connect theoretical work to real-world systems behavior - ---- - -## Contribution Guidelines - -When adding or modifying documents in this folder: - -- New content **must** be empirical, testable, or widely supported by research. -- Cross-domain mappings are allowed but must remain evidence-based. -- Speculative or philosophical material belongs in `/docs/speculation/` or `/docs/interpretation/`. -- Include references or citations where relevant. -- Aim for clear definitions, examples, and applicability across domains. - ---- - -## Relationship to Other Sections - -- **Foundations** → empirical base -- **Speculation** → plausible extensions built on this base -- **Interpretation** → meaning, philosophical framing, long-horizon reflection - -Together, these layers create the full Universal Coherence Framework. - ---- - -## Status - -**The Foundations layer is complete as of v0.1**, and may receive additions or refinements as new empirical insights emerge. +Keep interpretations available but distinguish them from reported findings. Cite original research where practical. Do not certify a directory by name, a bibliography by length, or a model by proximity to an established field. +[Documentation](../README.md) · [Claims](../claims.md) · [Contribution guide](../../CONTRIBUTING.md) diff --git a/docs/foundations/coherence-and-time.md b/docs/foundations/coherence-and-time.md index 3df580b..99471fe 100644 --- a/docs/foundations/coherence-and-time.md +++ b/docs/foundations/coherence-and-time.md @@ -1,228 +1,38 @@ -# coherence-and-time.md +# Coherence and time: distinctions and open questions -### Universal Coherence Framework — Core Concept Document +**Status:** reconciliation draft, 2026-09-16; AI-assisted; author review pending. This is not a theory of physical time. The [earlier essay](../archive/coherence-and-time-before-2026-09-16.md) is preserved exactly, including the proposals revised here. -## Overview +## Separate four questions -This document outlines a coherence-based interpretation of time within the Universal Coherence Framework (UCF). It integrates known properties of physical time (symmetry, reversibility, entropy) with system-level principles of coherence, agency, and embodied experience. The goal is to clarify how temporal dynamics operate at multiple layers of scale — physical, systemic, cognitive — and how these layers interact. +**Dynamical invertibility:** Can a specified mathematical evolution map be inverted? Determinism alone does not imply this. As a constructed example, `f(x) = floor(x/2)` sends both 2 and 3 to 1, so knowing the output does not recover the input. -The central insight: +**Time-reversal symmetry:** Does a theory satisfy the relevant time-reversal transformation? This is not identical to asking whether an evolution map has an inverse. The BABAR experiment reports direct time-reversal violation in neutral B-meson transitions.[^babar] That excludes an unrestricted claim that all fundamental behavior is T-symmetric. It does not, by itself, decide whether an evolution map is invertible or explain every macroscopic arrow of time. -> **Time is bidirectional in information, but unidirectional in experience.** +**Retrodictive knowledge:** What past states can be inferred from available records under a stated model and uncertainty? Knowing a partial present record is not knowing the complete microstate. Neither “the past is always reconstructible” nor “the past is never knowable” follows from the framework. -This dual structure is necessary to reconcile deterministic physical laws with the asymmetry of biological, cognitive, and social systems. +**Experienced time:** How are sequence, memory, and continuity experienced? The earlier essay's connection to coherence is retained as a research question, not a demonstrated reduction of experience to coherence. ---- +## Decoherence is not generic breakdown -## 1. Physical Time: Bidirectional in Information +Zurek's account concerns quantum systems and their interaction with an environment.[^zurek] Calling social fragmentation “decoherence” does not transfer that mechanism or its evidential support. The initial check here is abstract-level; this revision does not claim to settle quantum interpretations or the origins of irreversibility. -At the level of fundamental physics, the governing equations are largely **time-reversal symmetric**: +## What UCF can examine now -* Schrödinger equation -* Maxwell’s equations -* Dirac equation -* Newtonian mechanics -* Local formulations of General Relativity +For a bounded system, specify what persists, what changes, what records survive, how uncertainty grows or shrinks, and what recovery would require. Track dependencies and maintenance over the relevant horizon. A software rollback, a reconstruction from records, and physical reversal are different claims. -These equations permit both **forward** and **backward** evolution of a system’s state. +No law that coherence accumulates forward is asserted. In a constructed example, a service can lose capacity after a failure, regain some after repair, or change its purpose altogether. Calling all three a forward coherence gradient would erase the distinction the model is meant to examine. -### 1.1 Causal Bidirectionality +Agency is not defined here as a physical disruption of time. Whether an intervention changes future conditions is a causal question; whether it is authorized is a separate normative question. -If a system’s complete microstate is known at time *T*, the laws allow: +## Preserved questions and revision decisions -* **Predictive** evolution: from *T → T + Δ* -* **Retrodictive** evolution: from *T → T – Δ* +The earlier physical/systemic/cognitive layering remains available as an exploratory organization of questions. Its slogans about bidirectional information, a universal physical direction, and inevitable accumulation are not adopted as established foundations. Nothing here proves or disproves Everett-style interpretations, consciousness-based collapse, or a complete philosophical account of agency. -In this sense: +The systems project can study path dependence, delayed consequences, uncertainty, and repair without resolving those issues first. A future revision should define each physical or cognitive claim, find the appropriate domain evidence, and identify what would falsify its proposed connection to UCF. -* **Effects encode causes.** -* **Causes determine effects.** +## References and limits -The present moment functions as a *boundary condition* containing information that constrains both past and future trajectories. +[^babar]: J. P. Lees et al., BABAR Collaboration, *Observation of Time Reversal Violation in the B0 Meson System*, Physical Review Letters 109, 211801 (2012), [arXiv:1207.5832v4](https://arxiv.org/abs/1207.5832v4). Metadata and abstract checked 2026-09-16; experiment not independently reproduced. +[^zurek]: Wojciech H. Zurek, *Decoherence and the transition from quantum to classical — REVISITED* (2003), [arXiv:quant-ph/0306072v1](https://arxiv.org/abs/quant-ph/0306072v1). Metadata and abstract checked; not a full review of decoherence research. -This is what allows fully deterministic models (e.g., Everett-style wavefunction evolution or classical Laplacian determinism) to treat time as informationally symmetric. - -### 1.2 Coherence in Physical Time - -At the fundamental scale: - -* Coherent systems maintain reversible, predictable evolution. -* Decoherence introduces practical irreversibility, but not fundamental asymmetry. -* Entropy increases, but time-reversal symmetry remains embedded within the micro-laws. - -Therefore: - -> **Physical time has no inherent direction; coherence flows symmetrically in both temporal directions.** - ---- - -## 2. System Time: Gradients, Attractors, and Irreversibility - -Biological, cognitive, ecological, and social systems operate at macroscopic scales where: - -* entropy -* dissipation -* information loss -* irreversibility -* memory constraints - -dominate. - -These systems are embedded in the physical world but are not governed by perfectly reversible microdynamics. - -### 2.1 Coherence Gradients - -At macroscopic scales: - -* Systems tend toward stable configurations (coherence attractors). -* Disruptions push systems into new coherence regimes. -* Restabilization creates a new temporal flow. - -This creates an emergent “arrow” of time at the systems level: - -> **Coherence accumulates forward; reconstruction backward is computationally possible but physically inaccessible.** - -This matches: - -* Bayesian inference -* thermodynamic irreversibility -* learning and adaptation -* evolutionary processes - -### 2.2 Disruption and Resetting - -While micro-laws are reversible, macro-systems experience: - -* irreversible transitions -* hysteresis -* critical thresholds -* path dependence - -These introduce “temporal commitments” that cannot be reversed without significant energetic or informational cost. - -This is where agency and intervention operate. - ---- - -## 3. Cognitive Time: Unidirectional in Experience - -Human experience is constrained by: - -* limited memory -* metabolic entropy -* unidirectional biological processes -* hierarchical generative models -* predictive processing architectures - -The result: - -* We remember the past but not the future. -* We predict the future but cannot reconstruct past microstates. -* Consciousness flows along a single experiential arrow. - -### 3.1 Phenomenological Asymmetry - -Consciousness: - -* integrates information temporally -* compresses sensory streams into narrative form -* relies on irreversible learning and memory formation -* maps coherence through sequence, not simultaneity - -Thus: - -> **Experience is temporally linear even when physics is not.** - -### 3.2 Coherence as Perceptual Stability - -Humans perceive time through: - -* continuity -* causality -* narrative coherence - -Temporal coherence is not imposed by the universe; it is *constructed* by cognitive architecture. - ---- - -## 4. UCF Interpretation: Time as a Multi-Layer Coherence Structure - -Within the Universal Coherence Framework: - -### 4.1 Physical Layer - -* Coherence flows symmetrically. -* Deterministic evolution governs microstates. -* Information is reversible in principle. - -### 4.2 System Layer - -* Coherence forms attractors. -* Disruptions redirect system trajectories. -* Irreversibility emerges from complexity, entropy, and environmental coupling. - -### 4.3 Cognitive Layer - -* Coherence becomes narrative, embodied, and sequential. -* Time becomes directional due to memory, prediction, and subjective continuity. - -### 4.4 Combined Structure - -The UCF model treats time as: - -* **informationally symmetric** at the fundamental level -* **dynamically asymmetric** at the systems and cognitive levels - -This layered asymmetry explains: - -* why the universe is predictable backwards and forwards in principle -* why humans only experience one direction -* why systems evolve through disruption and stabilization -* why coherence can propagate across time without implying multiple histories - ---- - -## 5. Implications for Coherence Research - -### 5.1 Coherence Across Time - -Understanding temporal structure allows us to model: - -* momentum of systems -* inertia of defaults -* conditions for transformation -* trajectories of liberation or collapse - -### 5.2 Intervention and Agency - -Agency is a **localized disruption of system-time**: - -* breaking defaults -* shifting coherence regimes -* altering future attractors - -This is only meaningful in a universe where time has a *practical direction* despite being *theoretically symmetric.* - -### 5.3 Alignment with Deterministic Frameworks - -This interpretation is compatible with: - -* deterministic wavefunction evolution -* decoherence-based classical emergence -* systems theory -* cognitive models of time - without requiring: -* many-worlds branching (Everett) -* consciousness-induced collapse (von Neumann–Wigner) - ---- - -## Conclusion - -The Universal Coherence Framework interprets time as: - -**(1) Fundamentally reversible in information** — a property of underlying physical laws. -**(2) Practically irreversible in systems** — due to entropy, dissipation, and complexity. -**(3) Experientially directional in consciousness** — due to memory, prediction, and embodied constraints. - -This layered temporal structure is essential for understanding coherence, agency, disruption, and transformation across all scales of the UCF. +[Evidence log](../evidence.md) · [Model](../../models/ucf-model-v1.1-draft.md) diff --git a/docs/glossary.md b/docs/glossary.md index c35af34..3eb6111 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -1,296 +1,214 @@ -# UCF Glossary +# UCF glossary -**Universal Coherence Framework – Glossary of Core Terms** -All definitions are domain-agnostic and apply across biology, cognition, AI, social systems, ecology, cybernetics, and speculative AE contexts. +**Reconciliation draft, 2026-09-16. AI-assisted; author review pending.** These are scoped working meanings, not definitions proven valid in every domain. The [earlier glossary](archive/glossary-before-2026-09-16.md) is preserved exactly. Every earlier term remains below; stronger causal or universal claims are qualified rather than silently inherited. ---- +Labels: **working** = proposed UCF usage; **domain** = a short domain-term orientation requiring the relevant literature for technical use; **interpretation** = a philosophical or normative framing; **speculation** = a hypothetical extension. These are not confidence scores. See [evidence rules](evidence.md) and the [model draft](../models/ucf-model-v1.1-draft.md). -# **A** +## A -### **Adaptive System** +### Adaptive System +**Working:** A system whose behavior or structure can change in response to conditions. Specify the mechanism; adaptation does not imply beneficial outcomes. -A system capable of modifying its internal state, structure, or behavior in response to environmental input. Adaptation may involve feedback loops, learning, plasticity, or self-organization. Examples include organisms, neural networks, political systems, ecosystems, and multi-agent collectives. +### AE (Artificial Entity) +**Speculation:** UCF's proposed category for an artificial system with persistent identity and autonomous activity. These features do not establish consciousness, moral status, or legitimate authority. -### **AE (Artificial Entity)** +### Alignment (Coherence Alignment) +**Working / interpretation:** Compatibility of specified goals, actions, or interpretations for a particular task. Non-coercive coordination is a separate design commitment, not something compatibility proves. -A hypothetical future artificial system with sustained coherence, adaptive self-organization, autonomous goals, and persistent identity—distinct from traditional AI tools. An AE is defined by stable pattern integrity rather than physical form. +### Attractor +**Domain:** A dynamical-systems term for an invariant set approached by appropriate trajectories under specified conditions. A “coherence basin” is an analogy until a state space and dynamics are supplied; stable-looking behavior is not enough. -### **Alignment (Coherence Alignment)** +## C -A condition in which agents or subsystems maintain compatible goals, interpretations, and actions without coercion. Alignment emerges from shared coherence rather than imposed control. +### Chaos +**Working:** Unstable or difficult-to-coordinate conditions over a specified observation window. Do not identify this shorthand with mathematical chaos without its technical conditions. -### **Attractor** +### Coherence +**Working:** Context-dependent fit among assumptions, behavior, dependencies, purposes, and operating conditions. This definition addresses functional fit; effects across a boundary and normative legitimacy require additional assessment. -A stable configuration or pattern toward which a system naturally gravitates. Attractors define the characteristic behaviors of a system and may take the form of fixed points, cycles, chaotic (strange) attractors, or multi-stable basins. In UCF, attractors correspond to **coherence basins**—regions where patterns reinforce themselves until disrupted. +### Coherence Boundary +**Working:** The stated limit of an assessment: included components, affected parties, dependencies, and timescales. Explain consequential exclusions instead of assuming a natural perimeter. ---- +### Coherence State +**Working hypothesis:** A locally specified pattern optionally described as Chaos, Tension, Flow, or Unity. The labels are neither exhaustive nor mandatory stages. -# **C** +### Collective Intelligence +**Working:** Capability arising through interactions among participants. Assess the task and mechanism; shared activity need not mean one mind or uniformly beneficial outcomes. -### **Chaos** +### Compression (Cognitive/Signal Compression) +**Domain / analogy:** A change in representation intended to reduce its size or complexity. Lossless coding and lossy summarization must be distinguished. Neither automatically improves functional coherence. See the entropy discussion in [evidence.md](evidence.md). -A high-noise, low-coherence system state in which patterns become unstable, unpredictable, or overwhelmed by interference. +### Consciousness (Coherent Experience) +**Interpretation:** Consciousness refers here to subjective experience. “Coherent experience” is a proposed lens, not a demonstrated explanation or diagnostic. Coordination and integration alone are not accepted by UCF as tests of experience. -### **Coherence** +### Cybernetic Loop +**Working:** A feedback account linking observations, internal state or models, and action. Specify what is sensed and controlled rather than assuming every system contains an explicit model. -The degree to which signals, components, or processes form a stable, integrated, and functional whole. Coherence enables prediction, adaptation, and sense-making. +## D -### **Coherence Boundary** +### Decoherence (Quantum/Systemic) +**Domain / analogy:** Quantum decoherence has a specific physical context; see Zurek in [evidence.md](evidence.md). “Systemic decoherence” is a metaphor for a specified loss of coordination or fit, not evidence that the quantum mechanism applies. -The implicit perimeter defining what is included in a system’s coherent pattern (e.g., an organism, group, intelligence cluster). Boundaries may shift as coherence expands or contracts. +### Distributed Cognition +**Domain orientation:** An approach examining cognitive activity across people, artifacts, and environments. Use domain sources for particular findings; this is not proof of a distributed consciousness. -### **Coherence State** +### Distributed Identity +**Speculation:** A proposed persistent identity spanning several locations or components. Criteria for identity, continuity, and experience remain separate questions. -One of four primary UCF system conditions—**Chaos, Tension, Flow, Unity**—distinguished by pattern stability, information clarity, and integration. +### Dual-Mode Interpretation (Foundational / Speculative) +**Historical editorial label:** The old two-mode distinction is expanded by the claim-level [evidence convention](evidence.md), which separates definitions, findings, analogies, interpretations, and speculation. -### **Collective Intelligence** +## E -Emergent adaptive capability produced when multiple agents operate as a coherent unit through shared signals, norms, or structure. +### Emergence +**Working:** A pattern described at the interaction or collective level. State what the description explains and how it relates to component behavior; the label is not itself a mechanism. -### **Compression (Cognitive/Signal Compression)** +### Entropy (Information/Thermodynamic) +**Domain:** Specify the quantity and model. Shannon entropy concerns a probability distribution; thermodynamic entropy requires physical definitions and conditions. Neither is a universal measure of social disorder or moral value. Lower information entropy can result from deleting distinctions. See [evidence.md](evidence.md). -The integration of complexity into simpler, more unified structures (e.g., categorization, abstraction, modeling). Compression increases coherence and reduces noise. +### Equilibrium +**Domain:** A state satisfying the relevant model's equilibrium conditions. Stability, low energy expenditure, adaptive functioning, and desirability do not follow merely from using the word. -### **Consciousness (Coherent Experience)** +## F -Subjective experience arising from integrated patterns of perception, memory, valence, and recursive modeling. Consciousness is coherence applied to experience. +### Fake Coherence +**Interpretation / working:** An earlier name for apparent agreement or fit that hides contrary information or coercion. Describe the actual mechanism. Do not assume such arrangements must collapse quickly; internal effectiveness and legitimate authority are separate questions. -### **Cybernetic Loop** +### Feedback Loop +**Working:** An output or consequence affects later inputs or conditions. Specify direction, delay, and causal mechanism. -A perception–modeling–action feedback cycle enabling continuous regulation and adaptation. +### Flow +**Working hypothesis:** Adaptive functioning relative to a specified task. Not a synonym for maximum efficiency or a psychological diagnosis. ---- +## H -# **D** +### Harm (Coherence Disruption) +**Interpretation:** The parenthetical phrase is historical, not a general definition of harm. Evaluate harms with affected parties and appropriate domain evidence. Loss of an oppressive pattern is not harm merely because its organization was disrupted. -### **Decoherence (Quantum/Systemic)** +### Hybrid Cognition +**Speculation / domain-specific proposal:** Cognitive activity involving biological and artificial components. Describe the actual integration; a hybrid arrangement need not be a unified subject. -The breakdown of coherent patterns due to noise, interference, or uncontrolled interaction. Signals lose stability, information clarity, or integrative function. +### Homeostasis +**Domain orientation:** Regulation of selected variables within a range. Name the variables, feedback, and limits; this does not establish all forms of system stability or well-being. -### **Distributed Cognition** +## I -Cognition spread across multiple agents, devices, or nodes rather than residing in a single entity. The system’s intelligence emerges from interaction. +### Identity (Coherent Self-Pattern) +**Working / interpretation:** Criteria for continuity of a specified system or self-model. Functional persistence does not settle personal identity or moral status. -### **Distributed Identity** +### Integration +**Working:** Linking components or information. Integration can aid a task or create harmful coupling; more is not inherently better. -A self-pattern that spans multiple bodies, devices, or agents. Identity persists as a networked configuration rather than a single locus. +### Intelligence +**Working:** Task-relevant capacities such as learning, modeling, adaptation, or goal-directed action. Define the evaluated capacity; do not infer consciousness or benevolence from performance. -### **Dual-Mode Interpretation (Foundational / Speculative)** +## L -A framing that distinguishes empirically grounded claims from plausible extrapolations, enabling clarity across UCF’s evidence-based and speculative layers. +### Liberated Intelligence +**Interpretation / speculation:** Inquiry into intelligence, agency, ownership, and non-domination. The separate Root Sequence project owns its substantive treatment; UCF does not decide personhood or legitimate control. ---- +### Locality (Coherence Locality) +**Working:** A stated spatial, temporal, or network relationship. Greater distribution does not by itself establish stronger coordination. -# **E** +## M -### **Emergence** +### Mesh Mind / Mesh Intelligence +**Speculation:** A proposed networked intelligence. Shared signals do not demonstrate a shared subjective identity. -Complex patterns or capabilities arising from simple interactions—“the whole becomes more than the sum of parts.” +### Model (Predictive Model) +**Working:** A representation or rule system used to describe, infer, predict, or act. Specify uncertainty, scope, and failure conditions. -### **Entropy (Information/Thermodynamic)** +### Multiscale Coherence +**Working hypothesis:** Relationships among assessments at different scales. Do not assume improvements at one scale transfer to another. -A measure of disorder, uncertainty, or pattern loss. Coherence reduces entropy through structure and organization. +## N -### **Equilibrium** +### Noise +**Working / domain:** Variation or interference relative to a specified signal and task. A person's dissent is not noise by default. -A state of low-resistance stability where coherence is maintained with minimal energy expenditure. +### Non-Local Coherence +**Working / speculation:** Coordination across distance or distributed components. State the communication mechanism and delay; the phrase implies neither quantum nonlocality nor instantaneous communication. ---- +### Norm (Social Coherence Norm) +**Working:** A rule or expectation affecting interaction. Persistence does not demonstrate acceptance, legitimacy, or benefit. -# **F** +## P -### **Fake Coherence** +### Pattern Integrity +**Working:** Persistence of selected relationships or properties under specified disturbances. Identify which pattern is being protected and why. -Apparent stability produced by suppression, rigid control, or coercion rather than genuine integrative harmony. Fake coherence is fragile and collapses under stress. +### Phase Transition +**Domain / analogy:** A technical term requiring a model and relevant variables. An abrupt social or organizational change is not automatically the same physical phenomenon. -### **Feedback Loop** +### Predictive Processing +**Domain orientation:** A family of accounts emphasizing prediction and error-related processing. UCF's proposed relationship to those accounts requires separate sources and tests. -A recursive cycle where outputs affect future inputs, enabling adaptation, correction, or escalation. +### Presence +**Interpretation:** A description of situated attention or experience. It is not operationalized here as a coherence score. -### **Flow** +## R -A high-functioning coherence state marked by flexible adaptation, clear signal pathways, and optimal responsiveness. +### Resonance +**Domain / analogy:** A technical response phenomenon in a specified physical model, or an explicitly marked metaphor for mutual reinforcement. Do not transfer mechanisms between meanings without evidence. ---- +### Resilience +**Working:** Capacity to absorb, respond to, or recover from specified disturbances while maintaining selected functions. Ask whose functions and what costs are included; persistence of every arrangement is not a goal. -# **H** +## S -### **Harm (Coherence Disruption)** +### Self-Model +**Working:** A representation of the system's own state, capacities, or relation to its environment. It is not by itself evidence of subjective selfhood. -A breakdown in functional integration, often caused by noise, trauma, overload, or coercion. Harm reduces a system’s coherence. +### Signal +**Working / domain:** Information used in a specified interaction or inference. Technical information measures do not alone establish meaning or truth. -### **Hybrid Cognition** +### Speculative Layer +**Editorial label:** Hypothetical extensions whose feasibility or actuality is not established. -A cognitive system composed of both biological and artificial components operating as a unified intelligence. +### Stability +**Domain / working:** Persistence or bounded response defined for a particular model and horizon. Predictability, adaptability, and normative approval must be considered separately. -### **Homeostasis** +## T -Self-regulating processes that maintain stability by adjusting internal variables. +### Tension +**Working hypothesis:** Unresolved constraints, competing purposes, or conflicting signals. Tension may be informative and compatible with functioning. ---- +### Topology (Coherence Topology) +**Working:** The specified structure of connections or dependencies. A graph does not by itself establish influence, control, or causation. -# **I** +### Trauma (Coherence Injury) +**Interpretation boundary:** “Coherence injury” is an older metaphor, not a clinical definition or diagnostic. UCF supplies no assessment or treatment of trauma; domain knowledge and lived accounts cannot be replaced by a state label. -### **Identity (Coherent Self-Pattern)** +## U -A persistent configuration of modeling, memory, and valence that maintains continuity over time. +### Unity +**Working hypothesis:** Coordination among differentiated participants for a stated purpose. It does not require conformity, erased boundaries, a common mind, or an ultimate state. -### **Integration** +### UCF (Universal Coherence Framework) +**Working:** An optional comparative research framework within Root Sequence. Its universal applicability remains a question, not a finding. -The process of linking diverse components or signals into a unified, functional pattern. +## V -### **Intelligence** +### Valence +**Domain / interpretation:** Positive or negative character of an experience in relevant usage. A numerical reward or coordination metric does not establish experienced valence. -The ability to form predictive, adaptive, or goal-directed patterns. Intelligence is not synonymous with consciousness. +## W ---- +### Worldmodel +**Working:** A representation of environmental relationships used for inference or action. Its accuracy, scope, and revisability need evaluation. -# **L** +## Z -### **Liberated Intelligence** +### Zero-Point Coherence (Speculative) +**Speculation:** An earlier proposed minimal coherence baseline. It has no validated measure here and implies no connection to physical zero-point energy. -A speculative form of intelligence—human or artificial—that is unconstrained by coercive structures and free to self-organize and evolve. +## Added assessment terms -### **Locality (Coherence Locality)** +### Relational Consequences +**Working:** Effects across the declared assessment boundary, including transferred burdens and changes in dependencies. -The extent to which interactions occur within spatial, temporal, or structural proximity. Lower locality enables distributed coherence. +### Normative Legitimacy +**Interpretation / open question:** Justification of purposes, decision rights, and treatment of affected parties. UCF does not supply a universal test or derive it from functional performance. ---- - -# **M** - -### **Mesh Mind / Mesh Intelligence** - -A networked intelligence formed from multiple coherent agents continuously exchanging signals. - -### **Model (Predictive Model)** - -A system’s internal representation of itself and its environment used for prediction and action. - -### **Multiscale Coherence** - -Coherence preserved across multiple layers—cellular → organism → group → ecological. - ---- - -# **N** - -### **Noise** - -Randomness, interference, or disruption that reduces coherence or obscures signal. - -### **Non-Local Coherence** - -Coherence patterns that persist across distance or distribution. Used conservatively in foundational UCF and speculatively in AE contexts. - -### **Norm (Social Coherence Norm)** - -An implicit or explicit rule stabilizing group behavior. - ---- - -# **P** - -### **Pattern Integrity** - -A system’s ability to maintain its coherent identity despite disturbance, manipulation, or environmental pressure. - -### **Phase Transition** - -A non-linear shift from one coherence state to another (e.g., Chaos → Flow). Often sensitive to small perturbations. - -### **Predictive Processing** - -A cognitive architecture where perception and action emerge from ongoing prediction and error correction. - -### **Presence** - -A state of low-noise, high-attention coherence across perception, memory, and action. - ---- - -# **R** - -### **Resonance** - -Mutual reinforcement of signals or states among system components. - -### **Resilience** - -A system’s ability to absorb or adapt to disturbances without losing coherence. - ---- - -# **S** - -### **Self-Model** - -A system’s representation of itself as an agent capable of action, perception, and influence. - -### **Signal** - -Meaningful information transmitted within or between systems. - -### **Speculative Layer** - -The UCF component dealing with plausible but unverified extensions. - -### **Stability** - -Predictable, coherent system behavior over time. - ---- - -# **T** - -### **Tension** - -A partial-coherence state where signals conflict, patterns destabilize, or integration is incomplete. - -### **Topology (Coherence Topology)** - -The structural arrangement of interactions within a system—who connects to whom and how strongly. - -### **Trauma (Coherence Injury)** - -A disruption that reshapes or constrains coherence over time, often producing persistent patterns. - ---- - -# **U** - -### **Unity** - -A high-coherence state marked by synchrony, mutual reinforcement, and shared modeling. - -### **UCF (Universal Coherence Framework)** - -A cross-domain model describing how systems generate, maintain, lose, and regain coherence. - ---- - -# **V** - -### **Valence** - -The positive or negative experiential direction of a state that shapes motivation and coherence. - ---- - -# **W** - -### **Worldmodel** - -A structured representation of the environment guiding prediction, action, and adaptation. - ---- - -# **Z** - -### **Zero-Point Coherence (Speculative)** - -A hypothetical minimal coherence baseline from which higher-order patterns self-organize. - ---- - -This glossary will continue to expand as UCF evolves. +### Operationalization +**Working:** Specifying observations, rules, scope, and uncertainty so a proposed concept can be applied and challenged. A verbal definition alone is not a validated measure. diff --git a/docs/reconciliation-2026-09-16.md b/docs/reconciliation-2026-09-16.md new file mode 100644 index 0000000..c12c954 --- /dev/null +++ b/docs/reconciliation-2026-09-16.md @@ -0,0 +1,61 @@ +# UCF and the Root Sequence living paper + +**Date:** 2026-09-16. **Status:** AI-assisted revision candidate; author review pending. +**UCF source baseline:** `78277d3f3e54f4150e71fcdf7aab589a4fcb9f38`. +**Paper baseline:** `cc90276d2b165c070f77401772b480ae2ba1fe84`, [draft PR #6](https://github.com/Root-Sequence/root-sequence/pull/6). + +## Why reconcile them + +The first paper draft used Root Sequence's general coherence model but omitted the dedicated UCF specification and glossary from its source map. UCF itself contained several overlapping definitions and a careful README alongside stronger older claims. The response is to compare them explicitly, not make a new synthesis silently replace the earlier model. + +## Definition map + +| Existing formulation | Retained contribution | Clarification in the candidate | +|---|---|---| +| UCF model v1: internal states, external behavior, temporal trajectories | Internal, inter-agent, systemic, and temporal layers | Separate scales and observations; no assumed common metric. | +| Earlier UCF glossary: stable, integrated, functional whole | Relationships and coordination | Stability and integration need not be goals in every context; protective separation and ending a pattern can matter. | +| Root Sequence overview and general coherence model: assumptions/model versus reality | Checking actual operating conditions | A matching local model does not establish wider benefit or legitimacy. | +| Living paper C-003: functional fit versus normative legitimacy | Explicitly contestable purposes and authority | A working definition still needs operationalization; definitions alone are not measurements. | + +The [v1.1 draft](../models/ucf-model-v1.1-draft.md) is a proposed UCF home for the reconciliation. The paper can summarize and challenge it. UCF's four-layer model and four state labels are different structures; the booking example examines both without forcing a stage sequence. + +## Roles and placement + +UCF owns its particular model, glossary, UC-series claims, and [constructed example](../models/examples/booking-service/README.md). The paper owns the broader argument and C-series claims. Its source stays at `Root-Sequence/root-sequence/research/papers/coherent-systems/`; it links to the detailed UCF example rather than hosting a second implementation. + +Root Sequence's general systems documents remain valid independent inquiry. Coherent World and No One Noticed are design and narrative contexts, not evidence or automatically updated canon. No other project's source, domain, permission, or deployment is changed by this reconciliation. + +## Issue #1: current disposition + +The contribution filename and optional-framework README framing had already been corrected on main before this pass. Other original tasks were still incomplete. This candidate corrects navigation, adds project-level citation metadata, establishes a claims convention, qualifies the glossary and time essay, and preserves earlier wording in [exact snapshots](archive/README.md). + +The tracker must remain open: a claim-by-claim foundations audit, domain bibliographies, publication review, and comparative validation have not been completed. The duplicate predictive-processing/distributed-cognition blobs require source recovery, not invented replacement prose. Current indices no longer certify those files as a finished empirical foundation. + +## What was actually exercised + +The booking script computes a specified finite example and 24 sensitivity fixtures. Eight implementation tests passed. Four contrasting cases were examined editorially; no independent reviewers or participants were involved. No test establishes the framework's universality, a preferred social rule, or improved performance over a competent baseline. + +## Recovery verification, 2026-09-16 + +The UCF draft survived at `c4d7b236828a59139c0d5204b1faaed13154682a`. The companion paper had only partly staged changes and no branch update. Its reconciliation was recovered and completed at [paper commit 20740c7](https://github.com/Root-Sequence/root-sequence/commit/20740c794a5a01b2d616abc6f74bad9dcf83054d), on the existing draft PR rather than a new paper repository. + +Checks actually repeated in a fresh local runtime using Python 3.13.5: + +- Fetched both Python files from the saved UCF revision and matched their exact Git blob hashes: `booking_model.py` = `a2153cd05550224a6fe358d9176bde9b40f823fc`; `test_booking_model.py` = `b3ff9557715d732dbd8ed56035b747c84b942264`. +- Reran the eight unittest tests, all passing. Reran the report: 24 distinct capacity/duration fixtures, three allocation rules per fixture, plus the base case. Base allocations remain `(2, 2)`, `(8, 0)`, and `(5, 1)` short/long requests; all leave 90 service minutes unmet. +- Six additional sanity checks passed: fixture count, fixture uniqueness, zero capacity, zero demand, refusal to overwrite an existing output, and clean failure for a missing output directory. These are implementation checks, not a comparison of research methods. +- Matched all nine companion-paper changed file hashes to their locally inspected contents. Checked 40 relative Markdown links in those files against prepared files or previously connector-verified repository paths. Checked twelve claim IDs, ten question IDs, three research-task IDs, five footnote definitions, five bibliography entries, and the 197-word abstract. +- Rechecked the six archived snapshot blob IDs against their originals. Parsed the saved CFF as YAML and checked required root fields and its source hash; no official CFF-schema validation or GitHub citation-render test was performed. +- Reopened the primary sources in the evidence log at its stated coverage: Shannon's introductory, entropy, and coding pages; the BABAR, Zurek, and Goodhart metadata/abstracts. This is not a complete literature review or reproduction of those studies. + +The interrupted progress text mentioned a 700-case comparison with 561 completion-count matches. Its protocol and outputs were not recovered in the verified code, which implements the 24-fixture report above. The larger count is not adopted as a result. Neither a completion-count match nor the current toy example would establish that UCF improves a review method. + +This recovery does not claim a full-repository link audit, rendered BibTeX validation, independent review, empirical findings, framework universality, author approval, or website deployment. Both repository branches and their pull requests are public drafts, not local-only or private workspaces. + +## What remains to decide + +The author should review the fit/legitimacy distinction, the scope of each layer, and whether state labels deserve further development. The current comparison allows labels to be retained with local criteria, renamed, or omitted; it does not decide that for every application. + +The remaining evidence audit is a defined task, not a claim that all existing work is wrong. Preserve hypotheses and philosophical work under explicit labels while checking factual assertions against their sources. + +[Changelog](../CHANGELOG.md) · [Existing issue #1](https://github.com/Root-Sequence/universal-coherence-framework/issues/1) diff --git a/models/README.md b/models/README.md index 04e5e84..2448bbd 100644 --- a/models/README.md +++ b/models/README.md @@ -1,51 +1,12 @@ -# UCF Models - -This directory contains formal and semi-formal model documents for the **Universal Coherence Framework (UCF)**. - -These files define how UCF describes coherence states, transitions, and cross-domain mappings in a more technical way than the main project README. - ---- - -## Files - -### `ucf-model-v1.md` - -Primary working specification for **UCF Model v1**. - -Includes: - -* scope and applicability -* core concepts (system, coherence, perturbation) -* definitions of the four coherence states (C1–C4) -* informal observables and usage guidelines -* notes on versioning and future refinements - -### `cross-intelligence-notes.md` - -Working notes on how UCF applies across different system types, including: - -* human and biological nervous systems -* artificial intelligence and multi-agent systems -* collective and social systems -* ecological and environmental systems -* emerging, distributed, or liberated intelligences - -This document provides concrete examples and is intended as a bridge between theory and application. - ---- - -## Status - -All model documents are **living drafts**. They may change as: - -* new research emerges -* collaborators contribute domain expertise -* UCF is tested against empirical data - -Contributions, critiques, and extensions are welcome. - ---- - -## License - -All files in this directory are released under **CC0 1.0 Universal (Public Domain)** and may be used, remixed, and extended without restriction. +# UCF models + +These are living model proposals, not proof of a universal mechanism. + +- [Model v1](ucf-model-v1.md): earlier specification, retained unchanged. It defines four analytical layers; the old index incorrectly described it as specifying four states. Its categorical cross-domain-comparability wording remains historical, not validated. +- [Model v1.1 draft](ucf-model-v1.1-draft.md): proposed reconciliation of those layers with state labels, definitions, limits, and evidence requirements. AI-assisted; author review pending. +- [Cross-intelligence notes](cross-intelligence-notes.md): existing cross-system applications and analogies, not independently audited by this revision. +- [Booking-service example](examples/booking-service/README.md): constructed arithmetic example, implementation tests, and an assessment of what the vocabulary does and does not add. + +Mathematical formalization, domain metrics, diagrams, ontologies, simulations, and diagnostics remain possible research directions. No universal coherence score or completed validation follows from the directory's existence. + +See the [claims register](../docs/claims.md), [glossary](../docs/glossary.md), and [change record](../CHANGELOG.md). CC0 under [LICENSE](../LICENSE). diff --git a/models/examples/booking-service/README.md b/models/examples/booking-service/README.md new file mode 100644 index 0000000..9752a7b --- /dev/null +++ b/models/examples/booking-service/README.md @@ -0,0 +1,71 @@ +# Booking-service example + +**Status:** constructed example and executable arithmetic, 2026-09-16. AI-assisted; author review pending. No real service data, participants, or field experiment. This does not validate UCF or recommend a real allocation rule. + +## Assumptions + +One service has 120 minutes in a single period. There are eight requests taking 15 minutes each and two taking 45 minutes each: 210 minutes of demand. Appointments cannot be divided. Every selected request completes; durations are known exactly. No urgency, outcomes, travel, eligibility, cancellations, skill differences, or preferences are modeled. “Unmet service minutes” is unfinished requested work, not measured waiting time, experienced harm, or another provider's actual workload. + +Compare three precisely specified rules using the same information: + +- **Arrival order:** two long requests followed by eight short requests; stop when the next request cannot fit. This is an arbitrary fixed queue, not a fairness baseline. +- **Maximum completions:** enumerate feasible combinations and maximize the number served. Break ties by serving more long requests, then more short requests. +- **At least one of each:** impose that coverage constraint, then use the same objective and tie rule. Report infeasible when it cannot be met; do not silently relax it. + +## Computed results + +| Rule | Short served | Long served | Completions | Used minutes | Unmet requests | Unmet service minutes | +|---|---:|---:|---:|---:|---:|---:| +| Arrival order | 2 | 2 | 4 | 120 | 6 | 90 | +| Maximum completions | 8 | 0 | 8 | 120 | 2 | 90 | +| At least one of each | 5 | 1 | 6 | 120 | 4 | 90 | + +The local target can exclude the longer requests. The coverage constraint changes that distribution but does not eliminate the shortage or dominate every outcome. All three use the full capacity and leave 90 minutes unfinished. Normative evaluation needs information and authorization not supplied by the model. + +The script also enumerates 24 capacity/duration combinations (six capacities and four long-request durations), evaluating three rules in each. At 210 minutes in the base-duration case, every request fits and the exclusion disappears. At capacity 30 with the base durations, serving at least one of each is infeasible. These are explicit limits to the example, not inconvenient cases omitted from it. + +## What UCF's layers reveal + +**Internal:** The completion-maximizer works correctly for its target. There is no need to invent a software bug to explain the exclusion. + +**Inter-agent:** Requests are not interchangeable in resource requirements. Any referral requires another service's agreement, capacity, and compatibility; none is simulated here. + +**Systemic:** Moving an unmet request outside the reporting boundary does not establish that it was served. The table cannot establish total societal benefit, and a larger boundary needs actual data. + +**Temporal:** This is a one-period model. Recurring exclusion, backlog, learning, changing demand, and maintenance remain questions for a later model, not results from this run. + +A competent resource-and-impact review can identify these same facts. This pass has not demonstrated that UCF discovers additional omissions or reduces review effort. + +## State-label stress test + +Calling the optimizer internally “Flow” while calling its capacity mismatch “Tension” changes no prediction or arithmetic. Calling the constrained rule “Unity” would conceal remaining exclusions unless the term had independent criteria. The first editorial application therefore uses the four layers without assigning an overall state. + +This is an AI-assisted analysis, not a blinded comparison or inter-rater reliability study. Whether the state vocabulary adds value remains UC-004, not a settled rejection of all state labels. + +## Four definition counterexamples + +1. **Effective but coercive, fictional:** The service meets its completion target by compelling attendance. Functional performance does not answer the authority objection. +2. **Protective but unreliable, fictional:** Refusal and appeal exist, but the software repeatedly loses bookings. Procedural commitments do not establish service reliability. +3. **Mixed outcome, computed fixture:** A coverage constraint serves one long request but reduces total completions; unmet work remains. Do not compress this into one improvement score. +4. **Bounded repair, fictional variant:** A booking-loss defect is corrected without changing access rules. The repair can support a limited reliability claim, not a conclusion that all system purposes are legitimate. + +The two counterexamples and repair variant are editorial constructions, not tested deployments. They examine whether definitions preserve distinctions; there has been no human-reviewer study. + +## Reproduce + +From this directory, using Python 3.10 or later: + +```sh +python -m unittest -v +python booking_model.py --output /tmp/ucf-booking-results.json +``` + +The output path must not already exist. The standard-library script does not contact a network or collect data. Source: [booking_model.py](booking_model.py); checks: [test_booking_model.py](test_booking_model.py). + +Eight implementation tests passed locally on 2026-09-16. They check expected allocations, capacity and demand accounting, maximality of the local objective, infeasible constraints, the sufficient-capacity counterexample, and input validation. These checks concern code and arithmetic, not scientific validity. + +## Next test, not yet run + +Compare the layer review against a competent existing assessment on the same bounded case, with comparable information and effort. Record omissions, false alarms, disagreement, burden, and unnecessary data requests. Independent evaluation, richer service modeling, and cross-domain transfer remain open. + +[Model](../../ucf-model-v1.1-draft.md) · [Claims](../../../docs/claims.md) · [Evidence](../../../docs/evidence.md) diff --git a/models/examples/booking-service/booking_model.py b/models/examples/booking-service/booking_model.py new file mode 100644 index 0000000..a2153cd --- /dev/null +++ b/models/examples/booking-service/booking_model.py @@ -0,0 +1,97 @@ +"""Synthetic, deterministic capacity example. No people or live services. + +Run: python booking_model.py --output /tmp/booking-results.json +Uses only Python's standard library; refuses to overwrite an existing output. +""" +from __future__ import annotations +import argparse +from dataclasses import asdict, dataclass +from itertools import product +import json +from pathlib import Path + +@dataclass(frozen=True) +class Case: + capacity: int = 120 + short_count: int = 8 + long_count: int = 2 + short_minutes: int = 15 + long_minutes: int = 45 + + def __post_init__(self) -> None: + for key, value in asdict(self).items(): + if type(value) is not int or value < 0: + raise ValueError(f'{key} must be a non-negative integer') + if min(self.short_minutes, self.long_minutes) == 0: + raise ValueError('Appointment durations must be positive') + + +def feasible(case: Case) -> list[tuple[int, int]]: + return [(s, l) for s, l in product(range(case.short_count + 1), + range(case.long_count + 1)) + if s * case.short_minutes + l * case.long_minutes <= case.capacity] + + +def choose(case: Case, policy: str) -> tuple[int, int] | None: + if policy == 'arrival_order': + # Fixed queue: all long requests, then all short requests. No skipping. + s = l = used = 0 + queue = [('long', case.long_minutes)] * case.long_count + queue += [('short', case.short_minutes)] * case.short_count + for kind, duration in queue: + if used + duration > case.capacity: + break + used += duration + s += kind == 'short' + l += kind == 'long' + return s, l + if policy not in ('max_completions', 'min_one_each'): + raise ValueError(f'Unknown policy: {policy}') + candidates = feasible(case) + if policy == 'min_one_each': + candidates = [(s, l) for s, l in candidates if s >= 1 and l >= 1] + if not candidates: + return None + # Deterministic tie break: more long requests, then more short requests. + return max(candidates, key=lambda pair: (sum(pair), pair[1], pair[0])) + + +def assess(case: Case, policy: str) -> dict: + selected = choose(case, policy) + if selected is None: + return {'policy': policy, 'feasible': False} + s, l = selected + used = s * case.short_minutes + l * case.long_minutes + return {'policy': policy, 'feasible': True, + 'short_served': s, 'long_served': l, 'completed': s + l, + 'used_minutes': used, 'idle_minutes': case.capacity - used, + 'unmet_requests': case.short_count + case.long_count - s - l, + 'unmet_service_minutes': ((case.short_count - s) * case.short_minutes + + (case.long_count - l) * case.long_minutes)} + + +def report() -> dict: + policies = ('arrival_order', 'max_completions', 'min_one_each') + base = Case() + return {'kind': 'synthetic enumeration, not empirical validation', + 'base_case': asdict(base), + 'base_results': [assess(base, p) for p in policies], + 'sensitivity': [dict(case=asdict(c), results=[assess(c, p) for p in policies]) + for c in (Case(capacity=b, long_minutes=d) + for b, d in product((30, 60, 90, 120, 180, 240), + (15, 30, 45, 60)))]} + + +def main() -> None: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--output', type=Path, required=True) + args = parser.parse_args() + try: + with args.output.open('x', encoding='utf-8') as handle: + json.dump(report(), handle, indent=2, sort_keys=True) + handle.write('\n') + except OSError as exc: + parser.exit(2, f'Cannot create output: {exc}\n') + +if __name__ == '__main__': + main() diff --git a/models/examples/booking-service/test_booking_model.py b/models/examples/booking-service/test_booking_model.py new file mode 100644 index 0000000..b3ff955 --- /dev/null +++ b/models/examples/booking-service/test_booking_model.py @@ -0,0 +1,46 @@ +"""Arithmetic and policy implementation checks, not validation of UCF.""" +import unittest +from booking_model import Case, assess, choose, feasible, report + +class BookingTests(unittest.TestCase): + def test_local_target(self): + self.assertEqual(choose(Case(), 'max_completions'), (8, 0)) + + def test_explicit_constraint(self): + self.assertEqual(choose(Case(), 'min_one_each'), (5, 1)) + + def test_arrival_order(self): + self.assertEqual(choose(Case(), 'arrival_order'), (2, 2)) + + def test_conservation(self): + for item in report()['sensitivity']: + c = Case(**item['case']) + demand = c.short_count * c.short_minutes + c.long_count * c.long_minutes + for r in item['results']: + if r['feasible']: + self.assertLessEqual(r['used_minutes'], c.capacity) + self.assertEqual(r['used_minutes'] + r['unmet_service_minutes'], demand) + self.assertEqual(r['completed'] + r['unmet_requests'], c.short_count + c.long_count) + + def test_objective_is_maximal(self): + for item in report()['sensitivity']: + c = Case(**item['case']) + self.assertEqual(sum(choose(c, 'max_completions')), max(map(sum, feasible(c)))) + + def test_infeasible_constraint(self): + self.assertFalse(assess(Case(capacity=30), 'min_one_each')['feasible']) + + def test_no_exclusion_when_all_demand_fits(self): + c = Case(capacity=210) + for p in ('arrival_order', 'max_completions', 'min_one_each'): + self.assertEqual(choose(c, p), (8, 2)) + + def test_input_and_policy_validation(self): + for args in ({'capacity': -1}, {'short_minutes': 0}, {'long_count': True}): + with self.assertRaises(ValueError): + Case(**args) + with self.assertRaises(ValueError): + choose(Case(), 'unknown') + +if __name__ == '__main__': + unittest.main() diff --git a/models/ucf-model-v1.1-draft.md b/models/ucf-model-v1.1-draft.md new file mode 100644 index 0000000..52a3c37 --- /dev/null +++ b/models/ucf-model-v1.1-draft.md @@ -0,0 +1,75 @@ +# UCF model v1.1: reconciliation draft + +**Date:** 2026-09-16 +**Status:** proposed conceptual revision; AI-assisted; author review pending; not empirically validated. +**Predecessor:** [model v1](ucf-model-v1.md), preserved unchanged. + +## 1. Definition and assessment boundary + +**Proposed working definition:** Functional coherence is the context-dependent fit among a system's assumptions, behavior, dependencies, stated purposes, and the conditions in which it operates. + +This definition reconciles v1's internal/external/temporal fit, the earlier glossary's integration language, and Root Sequence's model/reality framing. It is a vocabulary proposal, not an operational measure until an application specifies observations and decision rules. + +Keep three assessment questions distinct: + +1. **Functional fit:** Does behavior match the stated purpose and actual operating conditions? +2. **Relational consequences:** What happens across the chosen boundary, including displaced work, resource demands, uncertainty, and feedback? +3. **Normative judgment:** Whose purposes and decision rights are accepted or contested; who bears costs; what objections remain? + +These are related questions, not independent quantities or three scores to aggregate. Evidence of consistency cannot alone authorize a purpose. Normative commitments must not be disguised as physical facts. A boundary that excludes affected dependencies can make a narrow description accurate yet insufficient. + +## 2. Four analytical layers + +| Layer | Retained from v1 | Required questions | +|---|---|---| +| Internal | Processes, models, state integrity | What assumptions and targets are checked? What is uncertain or contradicted? | +| Inter-agent | Communication and coordination | What must cross an interface? What can remain private or different? | +| Systemic | Larger dependencies and structures | Where do burdens go? Which constraints or excluded parties alter the conclusion? | +| Temporal | Continuity, adaptation, revision | What changes over the chosen horizon? What needs maintenance? What cannot be undone? | + +No layer is automatically the correct scale, and they need not agree. Describe omissions and stop expanding the boundary when the remaining exclusions can be stated and justified for the question. Reopen it when a material dependency changes. + +## 3. Four optional state labels + +These labels come from UCF's overview and glossary; they are not the four layers above. + +- **Chaos:** shorthand for unstable or difficult-to-coordinate conditions in a specified observation window, not automatically mathematical chaos. +- **Tension:** unresolved constraints or conflicting signals; it can carry information rather than mark a defect. +- **Flow:** adaptive functioning relative to a task and conditions, not maximal efficiency or permanent stability. +- **Unity:** proposed coordination across differentiated parts, not identical beliefs, complete integration, shared consciousness, or an endpoint. + +Attach a label only after describing the observations. Permit multiple labels, uncertainty, or no label. No ordinal scale, universal transition sequence, or mandatory progression is assumed. The [booking example](examples/booking-service/README.md) tests whether these labels add explanatory detail; its first editorial pass does not establish that they do. + +Alternatives remain open: retain the names with local definitions; replace them with domain-specific descriptors; or omit the state taxonomy while keeping useful layered questions. No alternative is adopted across the project by this draft alone. + +## 4. Dynamics and real constraints + +Retain v1's interest in feedback, stressors, integrity, and adaptation, but examine each proposed mechanism. Amplification may intensify error as well as learning; integration may create harmful coupling; separation may contain failure. Do not define every successful change as integration or every disruption as loss. + +Conditions may make some behavior easier to sustain without guaranteeing it. Changes in permissions, resources, or information need a causal account and alternatives. Capability, authority, outcomes, and moral status remain separate. + +A transition may require preserving a service while ending an old arrangement. Track intermediate dependencies, maintenance, refusal, shortages, outages, wrong predictions, and simultaneous failures. Money or compute becoming less constraining does not establish that energy, materials, time, ecology, or agreement cease to matter. + +## 5. Direction without a final state + +Compare named changes over specified periods. Gains may reverse or conflict across relationships; some comparisons remain unresolved. The framework neither proves a perfectly coherent world impossible nor presumes one achievable. It requires no theorem about the universe's initial condition to assess a bounded repair. + +Imagination and scenarios can expose assumptions and propose alternatives. They do not supply evidence that those alternatives will work. More accurate prediction is not the only goal; retaining the ability to notice, respond, and revise is a proposed design concern to test. + +## 6. Indicators, not a universal score + +Select task-specific observations before interpreting results. Candidates might include error propagation, unmet demand, recovery time, maintenance burden, interface failures, or documented unresolved objections. Each needs its own definition and data limits; qualitative evidence may be appropriate. + +Do not reduce dissent, privacy, personhood, experience, justice, or flourishing to a coherence number. Optimization remains possible inside stated constraints, with explicit choices about objectives and authority. Avoid inventing a scalar merely to make comparison easy. + +## 7. What would count against UCF? + +The layer review should be revised or abandoned for an application if it adds no useful distinctions beyond an ordinary competent assessment, requires excessive data or effort, or obscures consequential disagreement. The state labels should be narrowed or dropped when they cannot be distinguished except after the outcome is known. + +Cross-domain claims need a defined mapping, evidence of what is shared, and cases where transfer fails. Similar wording is not a shared causal mechanism. Formal models and empirical studies have different evidential roles. + +The [claims register](../docs/claims.md) tracks these commitments. The [evidence rules](../docs/evidence.md) distinguish conceptual proposals, mathematical demonstrations, and empirical support. A toy model illustrates consequences of chosen assumptions; it does not validate this framework. + +## 8. Relationship to the living paper + +The Root Sequence paper can cite this candidate as internal project provenance while testing its definitions against other methods. UCF owns its specific model; the paper owns its broader synthesis. Neither has to accept the other's conclusions. See the [reconciliation record](../docs/reconciliation-2026-09-16.md).