diff --git a/.internal/engineering/scripts/check_public_repo.sh b/.internal/engineering/scripts/check_public_repo.sh index be7d122..eda044b 100755 --- a/.internal/engineering/scripts/check_public_repo.sh +++ b/.internal/engineering/scripts/check_public_repo.sh @@ -22,6 +22,16 @@ required_files=( README.md README.en.md README.zh-CN.md + LICENSE + LICENSE-CODE + CITATION.cff + docs/README.md + docs/repository-map.md + docs/publishing.md + docs/owner-actions.md + assets/social-preview/README.md + assets/social-preview/og.svg + assets/social-preview/og.png .github/workflows/pages.yml .github/workflows/public-check.yml .github/pull_request_template.md @@ -106,7 +116,7 @@ unexpected_root_entries=() while IFS= read -r entry; do name="${entry#./}" case "$name" in - .git|.gitignore|.internal|README.md|README.en.md|README.zh-CN.md|.github|chapter1|chapter2) + .git|.gitignore|.internal|README.md|README.en.md|README.zh-CN.md|LICENSE|LICENSE-CODE|CITATION.cff|.github|assets|docs|chapter1|chapter2) ;; *) unexpected_root_entries+=("$name") @@ -116,7 +126,27 @@ done < <(find . -mindepth 1 -maxdepth 1 -print) if ((${#unexpected_root_entries[@]} > 0)); then printf '%s\n' "${unexpected_root_entries[@]}" - fail "Unexpected root-level entries found. Keep root visible topology to README language entries, .github/, chapter1/, chapter2/, and hidden internals." + fail "Unexpected root-level entries found. Keep root visible topology to README language entries, LICENSE/CITATION files, .github/, assets/, docs/, chapter1/, chapter2/, and hidden internals." +fi + +public_internal_links=() +while IFS= read -r path; do + case "$path" in + .internal/*|tmp/*|output/*) + ;; + *) + if [[ "$path" == *.md || "$path" == *.html ]]; then + if rg -q '\]\([^)]*\.internal/' "$path"; then + public_internal_links+=("$path") + fi + fi + ;; + esac +done < <(git ls-files --cached --others --exclude-standard) + +if ((${#public_internal_links[@]} > 0)); then + printf '%s\n' "${public_internal_links[@]}" + fail "Public Markdown/HTML must not link into .internal/." fi forbidden_tracked=() @@ -182,12 +212,24 @@ if ! rg -q 'README.en.md' README.md || ! rg -q 'README.zh-CN.md' README.md; then fail "README.md must expose English and Simplified Chinese language entries." fi -if ! rg -q '.internal/unpublished/wiki/Home.md' README.md; then - fail "README.md must link to the wiki source." +if ! rg -q 'docs/repository-map.md' README.md; then + fail "README.md must link to the public repository map." +fi + +if ! rg -q 'docs/owner-actions.md' README.md; then + fail "README.md must link to public owner actions." +fi + +if ! rg -q 'Creative Commons Attribution 4.0 International Public License' LICENSE; then + fail "Root LICENSE must contain the CC BY 4.0 legal code." +fi + +if ! rg -q 'MIT License' LICENSE-CODE; then + fail "Root LICENSE-CODE must contain the MIT license." fi -if ! rg -q '.internal/repository/policy/PUBLIC_RELEASE.md' README.md; then - fail "README.md must link to public release setup." +if ! rg -q '^license: CC-BY-4.0$' CITATION.cff; then + fail "CITATION.cff must declare license: CC-BY-4.0." fi if ((failures > 0)); then diff --git a/.internal/repository/legal/LICENSE.md b/.internal/repository/legal/LICENSE.md index 287207a..9e32648 100644 --- a/.internal/repository/legal/LICENSE.md +++ b/.internal/repository/legal/LICENSE.md @@ -1,5 +1,7 @@ # License +NOTE: The repository root LICENSE (CC BY 4.0) and LICENSE-CODE (MIT) are the canonical public license terms. This internal note is non-authoritative. + Copyright (c) 2026 constitutional_runtime authors. This repository is publicly readable as the mission, article, whitepaper, and diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..ca972b0 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,43 @@ +cff-version: 1.2.0 +message: "If you reference or build on this work, please cite it as below." +title: "constitutional_runtime: A Governed Runtime Architecture for Persistent Multi-Agent Task Execution" +abstract: >- + Public worldview, concept vocabulary, essay series, and technical whitepaper + for a governed persistent multi-agent runtime. It argues that reliable + long-running AI work requires a governed runtime in which mission ownership, + authority relations, evidence gates, state transitions, audit receipts, and + lawful closure are explicit runtime objects, organized around three + adjudicating spines: Constitutional Runtime (CR), Constitutional Kernel (CK), + and Mission Kernel (MK). +type: software +authors: + - family-names: "Chihvane" + # TODO(owner): add given-names if you want full-name citation, and ORCID if available. + # orcid: "https://orcid.org/0000-0000-0000-0000" +repository-code: "https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel" +url: "https://chihvane.github.io/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/" +license: CC-BY-4.0 +version: "chapter2-v7.3" +date-released: "2026-06-09" +keywords: + - multi-agent systems + - ai governance + - ai safety + - agent architecture + - large language models + - runtime architecture + - mission kernel + - constitutional runtime +references: + - type: article + title: "Chapter 1: Structural Instability in Agent OS" + authors: + - family-names: "Chihvane" + date-released: "2026-05-14" + notes: "Final v3. Canonical PDFs (zh/en) in chapter1/final-draft-v3/." + - type: article + title: "Chapter 2: The Problem Is Not Capability, But Organization Structure" + authors: + - family-names: "Chihvane" + date-released: "2026-06-09" + notes: "Final v7.3. Source package in chapter2/final-draft-v7.3/." diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..4ea99c2 --- /dev/null +++ b/LICENSE @@ -0,0 +1,395 @@ +Attribution 4.0 International + +======================================================================= + +Creative Commons Corporation ("Creative Commons") is not a law firm and +does not provide legal services or legal advice. Distribution of +Creative Commons public licenses does not create a lawyer-client or +other relationship. Creative Commons makes its licenses and related +information available on an "as-is" basis. Creative Commons gives no +warranties regarding its licenses, any material licensed under their +terms and conditions, or any related information. Creative Commons +disclaims all liability for damages resulting from their use to the +fullest extent possible. + +Using Creative Commons Public Licenses + +Creative Commons public licenses provide a standard set of terms and +conditions that creators and other rights holders may use to share +original works of authorship and other material subject to copyright +and certain other rights specified in the public license below. The +following considerations are for informational purposes only, are not +exhaustive, and do not form part of our licenses. + + Considerations for licensors: Our public licenses are + intended for use by those authorized to give the public + permission to use material in ways otherwise restricted by + copyright and certain other rights. Our licenses are + irrevocable. Licensors should read and understand the terms + and conditions of the license they choose before applying it. + Licensors should also secure all rights necessary before + applying our licenses so that the public can reuse the + material as expected. Licensors should clearly mark any + material not subject to the license. This includes other CC- + licensed material, or material used under an exception or + limitation to copyright. More considerations for licensors: + wiki.creativecommons.org/Considerations_for_licensors + + Considerations for the public: By using one of our public + licenses, a licensor grants the public permission to use the + licensed material under specified terms and conditions. If + the licensor's permission is not necessary for any reason--for + example, because of any applicable exception or limitation to + copyright--then that use is not regulated by the license. Our + licenses grant only permissions under copyright and certain + other rights that a licensor has authority to grant. Use of + the licensed material may still be restricted for other + reasons, including because others have copyright or other + rights in the material. A licensor may make special requests, + such as asking that all changes be marked or described. + Although not required by our licenses, you are encouraged to + respect those requests where reasonable. More considerations + for the public: + wiki.creativecommons.org/Considerations_for_licensees + +======================================================================= + +Creative Commons Attribution 4.0 International Public License + +By exercising the Licensed Rights (defined below), You accept and agree +to be bound by the terms and conditions of this Creative Commons +Attribution 4.0 International Public License ("Public License"). To the +extent this Public License may be interpreted as a contract, You are +granted the Licensed Rights in consideration of Your acceptance of +these terms and conditions, and the Licensor grants You such rights in +consideration of benefits the Licensor receives from making the +Licensed Material available under these terms and conditions. + + +Section 1 -- Definitions. + + a. Adapted Material means material subject to Copyright and Similar + Rights that is derived from or based upon the Licensed Material + and in which the Licensed Material is translated, altered, + arranged, transformed, or otherwise modified in a manner requiring + permission under the Copyright and Similar Rights held by the + Licensor. For purposes of this Public License, where the Licensed + Material is a musical work, performance, or sound recording, + Adapted Material is always produced where the Licensed Material is + synched in timed relation with a moving image. + + b. Adapter's License means the license You apply to Your Copyright + and Similar Rights in Your contributions to Adapted Material in + accordance with the terms and conditions of this Public License. + + c. Copyright and Similar Rights means copyright and/or similar rights + closely related to copyright including, without limitation, + performance, broadcast, sound recording, and Sui Generis Database + Rights, without regard to how the rights are labeled or + categorized. For purposes of this Public License, the rights + specified in Section 2(b)(1)-(2) are not Copyright and Similar + Rights. + + d. Effective Technological Measures means those measures that, in the + absence of proper authority, may not be circumvented under laws + fulfilling obligations under Article 11 of the WIPO Copyright + Treaty adopted on December 20, 1996, and/or similar international + agreements. + + e. Exceptions and Limitations means fair use, fair dealing, and/or + any other exception or limitation to Copyright and Similar Rights + that applies to Your use of the Licensed Material. + + f. Licensed Material means the artistic or literary work, database, + or other material to which the Licensor applied this Public + License. + + g. Licensed Rights means the rights granted to You subject to the + terms and conditions of this Public License, which are limited to + all Copyright and Similar Rights that apply to Your use of the + Licensed Material and that the Licensor has authority to license. + + h. Licensor means the individual(s) or entity(ies) granting rights + under this Public License. + + i. Share means to provide material to the public by any means or + process that requires permission under the Licensed Rights, such + as reproduction, public display, public performance, distribution, + dissemination, communication, or importation, and to make material + available to the public including in ways that members of the + public may access the material from a place and at a time + individually chosen by them. + + j. Sui Generis Database Rights means rights other than copyright + resulting from Directive 96/9/EC of the European Parliament and of + the Council of 11 March 1996 on the legal protection of databases, + as amended and/or succeeded, as well as other essentially + equivalent rights anywhere in the world. + + k. You means the individual or entity exercising the Licensed Rights + under this Public License. Your has a corresponding meaning. + + +Section 2 -- Scope. + + a. License grant. + + 1. Subject to the terms and conditions of this Public License, + the Licensor hereby grants You a worldwide, royalty-free, + non-sublicensable, non-exclusive, irrevocable license to + exercise the Licensed Rights in the Licensed Material to: + + a. reproduce and Share the Licensed Material, in whole or + in part; and + + b. produce, reproduce, and Share Adapted Material. + + 2. Exceptions and Limitations. For the avoidance of doubt, where + Exceptions and Limitations apply to Your use, this Public + License does not apply, and You do not need to comply with + its terms and conditions. + + 3. Term. The term of this Public License is specified in Section + 6(a). + + 4. Media and formats; technical modifications allowed. The + Licensor authorizes You to exercise the Licensed Rights in + all media and formats whether now known or hereafter created, + and to make technical modifications necessary to do so. The + Licensor waives and/or agrees not to assert any right or + authority to forbid You from making technical modifications + necessary to exercise the Licensed Rights, including + technical modifications necessary to circumvent Effective + Technological Measures. For purposes of this Public License, + simply making modifications authorized by this Section 2(a) + (4) never produces Adapted Material. + + 5. Downstream recipients. + + a. Offer from the Licensor -- Licensed Material. Every + recipient of the Licensed Material automatically + receives an offer from the Licensor to exercise the + Licensed Rights under the terms and conditions of this + Public License. + + b. No downstream restrictions. You may not offer or impose + any additional or different terms or conditions on, or + apply any Effective Technological Measures to, the + Licensed Material if doing so restricts exercise of the + Licensed Rights by any recipient of the Licensed + Material. + + 6. No endorsement. Nothing in this Public License constitutes or + may be construed as permission to assert or imply that You + are, or that Your use of the Licensed Material is, connected + with, or sponsored, endorsed, or granted official status by, + the Licensor or others designated to receive attribution as + provided in Section 3(a)(1)(A)(i). + + b. Other rights. + + 1. Moral rights, such as the right of integrity, are not + licensed under this Public License, nor are publicity, + privacy, and/or other similar personality rights; however, to + the extent possible, the Licensor waives and/or agrees not to + assert any such rights held by the Licensor to the limited + extent necessary to allow You to exercise the Licensed + Rights, but not otherwise. + + 2. Patent and trademark rights are not licensed under this + Public License. + + 3. To the extent possible, the Licensor waives any right to + collect royalties from You for the exercise of the Licensed + Rights, whether directly or through a collecting society + under any voluntary or waivable statutory or compulsory + licensing scheme. In all other cases the Licensor expressly + reserves any right to collect such royalties. + + +Section 3 -- License Conditions. + +Your exercise of the Licensed Rights is expressly made subject to the +following conditions. + + a. Attribution. + + 1. If You Share the Licensed Material (including in modified + form), You must: + + a. retain the following if it is supplied by the Licensor + with the Licensed Material: + + i. identification of the creator(s) of the Licensed + Material and any others designated to receive + attribution, in any reasonable manner requested by + the Licensor (including by pseudonym if + designated); + + ii. a copyright notice; + + iii. a notice that refers to this Public License; + + iv. a notice that refers to the disclaimer of + warranties; + + v. a URI or hyperlink to the Licensed Material to the + extent reasonably practicable; + + b. indicate if You modified the Licensed Material and + retain an indication of any previous modifications; and + + c. indicate the Licensed Material is licensed under this + Public License, and include the text of, or the URI or + hyperlink to, this Public License. + + 2. You may satisfy the conditions in Section 3(a)(1) in any + reasonable manner based on the medium, means, and context in + which You Share the Licensed Material. For example, it may be + reasonable to satisfy the conditions by providing a URI or + hyperlink to a resource that includes the required + information. + + 3. If requested by the Licensor, You must remove any of the + information required by Section 3(a)(1)(A) to the extent + reasonably practicable. + + 4. If You Share Adapted Material You produce, the Adapter's + License You apply must not prevent recipients of the Adapted + Material from complying with this Public License. + + +Section 4 -- Sui Generis Database Rights. + +Where the Licensed Rights include Sui Generis Database Rights that +apply to Your use of the Licensed Material: + + a. for the avoidance of doubt, Section 2(a)(1) grants You the right + to extract, reuse, reproduce, and Share all or a substantial + portion of the contents of the database; + + b. if You include all or a substantial portion of the database + contents in a database in which You have Sui Generis Database + Rights, then the database in which You have Sui Generis Database + Rights (but not its individual contents) is Adapted Material; and + + c. You must comply with the conditions in Section 3(a) if You Share + all or a substantial portion of the contents of the database. + +For the avoidance of doubt, this Section 4 supplements and does not +replace Your obligations under this Public License where the Licensed +Rights include other Copyright and Similar Rights. + + +Section 5 -- Disclaimer of Warranties and Limitation of Liability. + + a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE + EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS + AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF + ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, + IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, + WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR + PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, + ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT + KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT + ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. + + b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE + TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, + NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, + INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, + COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR + USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN + ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR + DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR + IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. + + c. The disclaimer of warranties and limitation of liability provided + above shall be interpreted in a manner that, to the extent + possible, most closely approximates an absolute disclaimer and + waiver of all liability. + + +Section 6 -- Term and Termination. + + a. This Public License applies for the term of the Copyright and + Similar Rights licensed here. However, if You fail to comply with + this Public License, then Your rights under this Public License + terminate automatically. + + b. Where Your right to use the Licensed Material has terminated under + Section 6(a), it reinstates: + + 1. automatically as of the date the violation is cured, provided + it is cured within 30 days of Your discovery of the + violation; or + + 2. upon express reinstatement by the Licensor. + + For the avoidance of doubt, this Section 6(b) does not affect any + right the Licensor may have to seek remedies for Your violations + of this Public License. + + c. For the avoidance of doubt, the Licensor may also offer the + Licensed Material under separate terms or conditions or stop + distributing the Licensed Material at any time; however, doing so + will not terminate this Public License. + + d. Sections 1, 5, 6, 7, and 8 survive termination of this Public + License. + + +Section 7 -- Other Terms and Conditions. + + a. The Licensor shall not be bound by any additional or different + terms or conditions communicated by You unless expressly agreed. + + b. Any arrangements, understandings, or agreements regarding the + Licensed Material not stated herein are separate from and + independent of the terms and conditions of this Public License. + + +Section 8 -- Interpretation. + + a. For the avoidance of doubt, this Public License does not, and + shall not be interpreted to, reduce, limit, restrict, or impose + conditions on any use of the Licensed Material that could lawfully + be made without permission under this Public License. + + b. To the extent possible, if any provision of this Public License is + deemed unenforceable, it shall be automatically reformed to the + minimum extent necessary to make it enforceable. If the provision + cannot be reformed, it shall be severed from this Public License + without affecting the enforceability of the remaining terms and + conditions. + + c. No term or condition of this Public License will be waived and no + failure to comply consented to unless expressly agreed to by the + Licensor. + + d. Nothing in this Public License constitutes or may be interpreted + as a limitation upon, or waiver of, any privileges and immunities + that apply to the Licensor or You, including from the legal + processes of any jurisdiction or authority. + + +======================================================================= + +Creative Commons is not a party to its public +licenses. Notwithstanding, Creative Commons may elect to apply one of +its public licenses to material it publishes and in those instances +will be considered the “Licensor.” The text of the Creative Commons +public licenses is dedicated to the public domain under the CC0 Public +Domain Dedication. Except for the limited purpose of indicating that +material is shared under a Creative Commons public license or as +otherwise permitted by the Creative Commons policies published at +creativecommons.org/policies, Creative Commons does not authorize the +use of the trademark "Creative Commons" or any other trademark or logo +of Creative Commons without its prior written consent including, +without limitation, in connection with any unauthorized modifications +to any of its public licenses or any other arrangements, +understandings, or agreements concerning use of licensed material. For +the avoidance of doubt, this paragraph does not form part of the +public licenses. + +Creative Commons may be contacted at creativecommons.org. diff --git a/LICENSE-CODE b/LICENSE-CODE new file mode 100644 index 0000000..85c9365 --- /dev/null +++ b/LICENSE-CODE @@ -0,0 +1,28 @@ +MIT License + +Copyright (c) 2026 Chihvane + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +---- + +Scope note: This MIT license applies ONLY to source code, scripts, and build +automation in this repository (e.g. Python, Shell, SCSS, CI config). All prose, +essays, whitepaper chapters, diagrams, and other written/visual content are +licensed separately under CC BY 4.0 (see the root LICENSE file). diff --git a/README.en.md b/README.en.md index 3f436f0..5973c55 100644 --- a/README.en.md +++ b/README.en.md @@ -1,10 +1,22 @@ # constitutional_runtime +**Constitutional Runtime is a governed runtime architecture for persistent multi-agent task execution. It separates capability from ownership, role from authority, memory from evidence, and local completion from lawful closure.** + +Long-running AI work cannot become reliable only by giving a single agent more memory, more tools, or a larger context window. It needs a governed runtime where **mission ownership, authority relations, evidence gates, state transitions, audit receipts, and lawful closure** become explicit runtime objects. + +## Read Now + +- [Chapter 1 Final v3](./chapter1/final-draft-v3/): structural instability in Agent OS, with Chinese and English canonical PDFs. +- [Chapter 2 Final v7.3](./chapter2/final-draft-v7.3/): why the root problem is organization structure, not capability. +- [Citation evidence](./chapter1/references/) and [reuse terms](./LICENSE): source support, licensing, and citation metadata. + [English](./README.en.md) | [简体中文](./README.zh-CN.md) [![Public Readiness](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml) [![Deploy GitHub Pages](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml) +## Repository Role + > A public worldview, concept system, article series, diagrams, evidence index, and whitepaper repository for governed persistent multi-agent runtime architecture. **Series:** *From Single-Agent OS to Constitutional Runtime: Why I Rebuilt My AI System* @@ -21,14 +33,6 @@ Repository slug: persistent--multi-agent--constitutional-runtime-kernel--mission-kernel ``` -## One-Sentence Thesis - -Long-running AI work cannot become reliable only by giving a single agent more memory, more tools, or a larger context window. It needs a governed runtime where **mission ownership, authority relations, evidence gates, state transitions, audit receipts, and lawful closure** become explicit runtime objects. - -## One-Sentence Definition - -**Constitutional Runtime is a governed runtime architecture for persistent multi-agent task execution. It separates capability from ownership, role from authority, memory from evidence, and local completion from lawful closure.** - Its goal is not to create "more agents." Its goal is to preserve, across long-running work: ```text @@ -245,9 +249,9 @@ Recommended path: 4. [Chapter 2 Version Map](./chapter2/) 5. [Chapter 2 Final v7.3](./chapter2/final-draft-v7.3/) 6. [Chapter 1 Reference Evidence](./chapter1/references/) -7. [Series Outline](./.internal/unpublished/series/outline.md) -8. [Whitepaper Outline](./.internal/unpublished/whitepaper/outline.md) -9. [Wiki Home](./.internal/unpublished/wiki/Home.md) +7. [Repository Map](./docs/repository-map.md) +8. [Public Publishing Notes](./docs/publishing.md) +9. [Owner Action Checklist](./docs/owner-actions.md) ## Public GitHub Configuration @@ -259,7 +263,7 @@ This repository uses the same public-facing conventions readers expect from acti - active public readiness workflow: [.github/workflows/public-check.yml](./.github/workflows/public-check.yml) - active GitHub Pages workflow: [.github/workflows/pages.yml](./.github/workflows/pages.yml) - CODEOWNERS: [.github/CODEOWNERS](./.github/CODEOWNERS) -- public release setup: [.internal/repository/policy/PUBLIC_RELEASE.md](./.internal/repository/policy/PUBLIC_RELEASE.md) +- public owner actions: [docs/owner-actions.md](./docs/owner-actions.md) Run the public readiness check before publishing or opening release-oriented pull requests: @@ -369,4 +373,15 @@ A public architecture, article, and whitepaper repository for a governed persist ## License / Reuse -Reuse terms are recorded in [.internal/repository/legal/LICENSE.md](./.internal/repository/legal/LICENSE.md). Until broader reuse rights are explicitly granted, treat this repository as public documentation and whitepaper draft material. When citing the project, cite the canonical Chapter 1 PDFs, the Chapter 1 GitHub Pages editions, or the Chapter 2 v7.3 package artifacts. +This repository uses a dual-track license: + +- **Written and visual content** — all essays, whitepaper chapters, diagrams, glossary entries, and publication packages — is licensed under **[Creative Commons Attribution 4.0 International (CC BY 4.0)](./LICENSE)**. You may share, quote, translate, and adapt it, including commercially, as long as you give appropriate credit. +- **Code** — scripts, build automation, and CI configuration — is licensed under the **[MIT License](./LICENSE-CODE)**. + +When citing this project, use the "Cite this repository" button powered by [`CITATION.cff`](./CITATION.cff), or: + +> Chihvane, "constitutional_runtime", 2026, +> https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel +> Licensed under CC BY 4.0. + +For chapter-level citation, cite the canonical Chapter 1 PDFs, Chapter 1 GitHub Pages editions, Chapter 2 v7.3 package artifacts, or tagged GitHub Releases when available. diff --git a/README.md b/README.md index efe0d70..b72a530 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,14 @@ # constitutional_runtime -[English](./README.en.md) | [简体中文](./README.zh-CN.md) +**Constitutional Runtime is a governed runtime architecture for persistent multi-agent task execution. It separates capability from ownership, role from authority, memory from evidence, and local completion from lawful closure.** -[![Public Readiness](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml) -[![Deploy GitHub Pages](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml) +Long-running AI work cannot become reliable only by giving one agent more memory, more tools, or a larger context window. It needs a governed runtime where mission ownership, authority relations, evidence gates, audit receipts, state transitions, and lawful closure are explicit runtime objects. -> Public mission, essays, diagrams, evidence indexes, and whitepaper drafts for a governed persistent multi-agent runtime. -> -> 面向受治理的持久化多智能体运行时的公开世界观、文章、图表、证据索引与白皮书草稿仓库。 +## Read Now + +- [Chapter 1 version map](./chapter1/): structural instability in Agent OS, with Chinese and English canonical PDFs. +- [Chapter 2 version map](./chapter2/): why the root problem is organization structure, not capability. +- [Citation evidence index](./chapter1/references/citation-evidence-index.md) and [reuse terms](./LICENSE) for quoting, translating, and citing the project. ## Choose A Language @@ -16,27 +17,24 @@ | English | [README.en.md](./README.en.md) | | 简体中文 | [README.zh-CN.md](./README.zh-CN.md) | +[![Public Readiness](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml) +[![Deploy GitHub Pages](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml) + +> Public mission, essays, diagrams, evidence indexes, and whitepaper drafts for a governed persistent multi-agent runtime. +> +> 面向受治理的持久化多智能体运行时的公开世界观、文章、图表、证据索引与白皮书草稿仓库。 + ## What This Repository Is This is the public documentation and publication home for `constitutional_runtime`. -It argues that long-running AI work cannot become reliable only by giving one agent more memory, more tools, or a larger context window. It needs a governed runtime where mission ownership, authority relations, evidence gates, audit receipts, state transitions, and lawful closure are explicit runtime objects. - 本仓库不是实现源码仓库。它公开的是概念、文章、白皮书路线、图表、引用证据与发布包；私有源码、私有 prompt、内部日志、凭证和运行痕迹不在这里公开。 -## Start Reading +## Public Orientation -- [English overview](./README.en.md) -- [中文总览](./README.zh-CN.md) -- [Chapter 1 version map](./chapter1/) -- [Chapter 1 Chinese final PDF](./chapter1/final-draft-v3/package-v3/chapter1.pdf) -- [Chapter 1 English final PDF](./chapter1/final-draft-v3/package-v3-en/chapter1.pdf) -- [Chapter 2 version map](./chapter2/) -- [Chapter 2 v7.3 GitHub Pages edition](./chapter2/final-draft-v7.3/github-pages.md) -- [Chapter 2 v7.3 Markdown source](./chapter2/final-draft-v7.3/package-v7.3/chapter2.md) -- [Citation evidence index](./chapter1/references/citation-evidence-index.md) -- [Wiki source](./.internal/unpublished/wiki/Home.md) -- [Public release setup](./.internal/repository/policy/PUBLIC_RELEASE.md) +- [Repository map](./docs/repository-map.md) +- [Public publishing notes](./docs/publishing.md) +- [Owner action checklist](./docs/owner-actions.md) ## Public GitHub Configuration @@ -79,3 +77,16 @@ Run the public readiness check before publishing: ```bash make -f .internal/engineering/Makefile check ``` + +## License / Reuse + +This repository uses a dual-track license: + +- **Written and visual content** is licensed under [Creative Commons Attribution 4.0 International (CC BY 4.0)](./LICENSE). +- **Code, scripts, build automation, and CI configuration** are licensed under the [MIT License](./LICENSE-CODE). + +When citing this project, use [CITATION.cff](./CITATION.cff) or cite: + +> Chihvane, "constitutional_runtime", 2026, +> https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel +> Licensed under CC BY 4.0. diff --git a/README.zh-CN.md b/README.zh-CN.md index 944dc9e..f666fcb 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,10 +1,22 @@ # constitutional_runtime +**Constitutional Runtime 是一种用于持久化多智能体任务执行的受治理运行时架构。它将 capability 与 ownership、role 与 authority、memory 与 evidence、local completion 与 lawful closure 分开。** + +长期运行的 AI 工作，不能只靠给单个 agent 更多记忆、更多工具或更大的上下文窗口来变得可靠。它需要一个受治理的运行时，使 **mission ownership、authority relations、evidence gates、state transitions、audit receipts 与 lawful closure** 成为显式的运行时对象。 + +## 现在阅读 + +- [Chapter 1 Final v3](./chapter1/final-draft-v3/)：Agent OS 的结构性失稳，包含中英文 canonical PDF。 +- [Chapter 2 Final v7.3](./chapter2/final-draft-v7.3/)：为什么根本问题是组织结构，而不是能力。 +- [引用证据](./chapter1/references/) 与 [复用许可](./LICENSE)：用于引用、翻译、改编与 citation。 + [English](./README.en.md) | [简体中文](./README.zh-CN.md) [![Public Readiness](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/public-check.yml) [![Deploy GitHub Pages](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml/badge.svg)](https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel/actions/workflows/pages.yml) +## 仓库角色 + > 一个面向持久化多智能体运行时的公开世界观、概念系统、系列文章与技术白皮书仓库。 **系列:** *From Single-Agent OS to Constitutional Runtime: Why I Rebuilt My AI System* @@ -19,14 +31,6 @@ `persistent--multi-agent--constitutional-runtime-kernel--mission-kernel` -## 一句话论点 - -长期运行的 AI 工作，不能只靠给单个 agent 更多记忆、更多工具或更大的上下文窗口来变得可靠。它需要一个受治理的运行时，使 **mission ownership、authority relations、evidence gates、state transitions、audit receipts 与 lawful closure** 成为显式的运行时对象。 - -## 一句话定义 - -**Constitutional Runtime 是一种用于持久化多智能体任务执行的受治理运行时架构。它将 capability 与 ownership、role 与 authority、memory 与 evidence、local completion 与 lawful closure 分开。** - 它的目的不是制造“更多 agent”，而是让长期 AI 工作持续保存： ```text @@ -600,8 +604,8 @@ Chapter 1 final release 有两个 canonical language editions。每个语言版 | Edition | Canonical PDF | Web Edition | Platform Package | |---|---|---|---| -| Chinese | [chapter1.pdf](./chapter1/final-draft-v3/package-v3/chapter1.pdf) | [GitHub Pages Markdown](./chapter1/final-draft-v3/github-pages.md) | [Publishing package](./.internal/unpublished/publishing/chapter-01/) | -| English | [chapter1.pdf](./chapter1/final-draft-v3/package-v3-en/chapter1.pdf) | [GitHub Pages Markdown](./chapter1/final-draft-v3/en/github-pages.md) | [Publishing package](./.internal/unpublished/publishing/chapter-01/en/) | +| Chinese | [chapter1.pdf](./chapter1/final-draft-v3/package-v3/chapter1.pdf) | [GitHub Pages Markdown](./chapter1/final-draft-v3/github-pages.md) | [Publishing package](./chapter1/final-draft-v3/package-v3/) | +| English | [chapter1.pdf](./chapter1/final-draft-v3/package-v3-en/chapter1.pdf) | [GitHub Pages Markdown](./chapter1/final-draft-v3/en/github-pages.md) | [Publishing package](./chapter1/final-draft-v3/package-v3-en/) | Source packages: @@ -640,15 +644,14 @@ Chapter 2 v7.3 目前发布为中文源稿包。你提供的 Pandoc HTML 已保 推荐阅读顺序： -1. [Series Outline](./.internal/unpublished/series/outline.md) -2. [Chapter 1 Version Map](./chapter1/) -3. [Chapter 1 Final v3](./chapter1/final-draft-v3/) -4. [Chapter 2 Version Map](./chapter2/) -5. [Chapter 2 Final v7.3](./chapter2/final-draft-v7.3/) -6. [Chapter 1 Reference Evidence](./chapter1/references/) -7. [Whitepaper Outline](./.internal/unpublished/whitepaper/outline.md) -8. [Glossary](./.internal/repository/concepts/glossary.md) -9. [Wiki Home](./.internal/unpublished/wiki/Home.md) +1. [Chapter 1 Version Map](./chapter1/) +2. [Chapter 1 Final v3](./chapter1/final-draft-v3/) +3. [Chapter 2 Version Map](./chapter2/) +4. [Chapter 2 Final v7.3](./chapter2/final-draft-v7.3/) +5. [Chapter 1 Reference Evidence](./chapter1/references/) +6. [Repository Map](./docs/repository-map.md) +7. [Public Publishing Notes](./docs/publishing.md) +8. [Owner Action Checklist](./docs/owner-actions.md) ## 发布输出 @@ -659,34 +662,19 @@ Chapter 2 v7.3 目前发布为中文源稿包。你提供的 Pandoc HTML 已保 - [Chinese GitHub Pages edition](./chapter1/final-draft-v3/github-pages.md) - [English GitHub Pages edition](./chapter1/final-draft-v3/en/github-pages.md) - [Chapter 2 v7.3 GitHub Pages edition](./chapter2/final-draft-v7.3/github-pages.md) -- Shared styling: [.internal/engineering/assets/main.scss](./.internal/engineering/assets/main.scss) +- Shared styling is maintained by the repository's Pages workflow. ### GitHub Wiki -GitHub Wiki 源稿保存在 [.internal/unpublished/wiki/](./.internal/unpublished/wiki/)，便于发布前 review。 - -Start pages: - -- [Wiki Home](./.internal/unpublished/wiki/Home.md) -- [Wiki Sidebar](./.internal/unpublished/wiki/_Sidebar.md) -- [Public Release Checklist](./.internal/unpublished/wiki/Public-Release-Checklist.md) -- [Wiki Sync Guide](./.internal/unpublished/publishing/wiki-sync.md) - -GitHub 会把 wiki 页面存放在单独的 `*.wiki.git` 仓库中。只有在 `make -f .internal/engineering/Makefile check` 通过后，才应从 `.internal/unpublished/wiki/` 发布。 +GitHub Wiki 源稿属于发布前 authoring material，不从公开 README 直接链接。公开读者应从本 README、[Repository Map](./docs/repository-map.md) 与 chapter version maps 进入。 ### Substack -- [Chinese Substack paste edition](./.internal/unpublished/publishing/chapter-01/substack/chapter1.substack.md) -- [English Substack paste edition](./.internal/unpublished/publishing/chapter-01/en/substack/chapter1.substack.md) - -Substack 不保留 custom CSS 或 pandoc div blocks，所以 Substack 版本将 definition/example boxes 展平为普通 Markdown，并使用明确的 figure-upload markers。 +Substack paste editions are prepared as internal publishing artifacts before publication. The public source of record remains the chapter package and canonical PDF for the matching language edition. ### Hugging Face -- [Chinese Hugging Face README edition](./.internal/unpublished/publishing/chapter-01/hugging-face/README.md) -- [English Hugging Face README edition](./.internal/unpublished/publishing/chapter-01/en/hugging-face/README.md) - -每个 Hugging Face package 都包含对应的 final PDF 与 figure assets。 +Hugging Face README editions are prepared as platform packages. Each public package should point back to the chapter version map and canonical chapter artifact. ## 引用证据 @@ -761,20 +749,21 @@ raw reference PDF corpus 默认不提交到仓库。这样可以保持公开仓 从这里开始： ```text -.internal/unpublished/series/outline.md chapter1/final-draft-v3/ -.internal/unpublished/whitepaper/outline.md -.internal/repository/concepts/glossary.md -.internal/unpublished/wiki/Home.md +chapter2/final-draft-v7.3/ +chapter1/references/ +docs/repository-map.md +docs/publishing.md ``` ### 发布 -使用生成好的平台发布包： +使用公开发布包： ```text -.internal/unpublished/publishing/chapter-01/ -.internal/unpublished/publishing/chapter-01/en/ +chapter1/final-draft-v3/package-v3/ +chapter1/final-draft-v3/package-v3-en/ +chapter2/final-draft-v7.3/package-v7.3/ ``` ### 验证引用 @@ -819,16 +808,13 @@ GitHub Actions 的公开入口保存在 `.github/workflows/`。`.internal/engine ## 公开发布设置 -公开发布配置记录在 [.internal/repository/policy/PUBLIC_RELEASE.md](./.internal/repository/policy/PUBLIC_RELEASE.md)。 +公开发布操作请参考 [Owner Action Checklist](./docs/owner-actions.md)。 Required local/public files include: -- [Environment metadata template](./.internal/engineering/site/.env.example) -- [License](./.internal/repository/legal/LICENSE.md) -- [Contribution guide](./.internal/repository/policy/CONTRIBUTING.md) -- [Security policy](./.internal/repository/policy/SECURITY.md) -- [Support policy](./.internal/repository/policy/SUPPORT.md) -- [Citation metadata](./.internal/repository/legal/CITATION.cff) +- [Content license](./LICENSE) +- [Code license](./LICENSE-CODE) +- [Citation metadata](./CITATION.cff) - [Active public readiness workflow](./.github/workflows/public-check.yml) - [Active GitHub Pages workflow](./.github/workflows/pages.yml) - [Bilingual issue template](./.github/ISSUE_TEMPLATE/docs_issue.yml) @@ -1159,4 +1145,15 @@ Mission is the unit of governance. ## License / Reuse -复用条款见 [.internal/repository/legal/LICENSE.md](./.internal/repository/legal/LICENSE.md)。在更宽泛的复用权利被明确授予之前，请将本仓库视为公开 documentation 与 whitepaper draft。引用本项目时，请引用 Chapter 1 的 canonical PDFs / GitHub Pages editions，或 Chapter 2 v7.3 的 package artifacts。 +本仓库采用双轨许可： + +- **文字与图示内容** —— 所有文章、白皮书章节、图表、术语表与发布包 —— 采用 **[知识共享 署名 4.0 国际 (CC BY 4.0)](./LICENSE)** 许可。在适当署名的前提下，你可以自由分享、引用、翻译并改编，包括商业用途。 +- **代码** —— 脚本、构建自动化与 CI 配置 —— 采用 **[MIT 许可](./LICENSE-CODE)**。 + +引用本项目时，请使用仓库页的 "Cite this repository" 按钮（由 [`CITATION.cff`](./CITATION.cff) 提供），或： + +> Chihvane, "constitutional_runtime", 2026, +> https://github.com/Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel +> 采用 CC BY 4.0 许可。 + +按章引用时，请引用各章 canonical PDF、Chapter 2 v7.3 package artifacts，或可用的 GitHub Release 标签。 diff --git a/assets/social-preview/README.md b/assets/social-preview/README.md new file mode 100644 index 0000000..7173c3f --- /dev/null +++ b/assets/social-preview/README.md @@ -0,0 +1,8 @@ +# Social Preview + +This directory stores the public Open Graph preview asset for the repository. + +- `og.svg`: reproducible source +- `og.png`: 1280 x 640 export for GitHub repository settings + +Owner action: upload `og.png` in GitHub repository settings under Social preview. diff --git a/assets/social-preview/og.png b/assets/social-preview/og.png new file mode 100644 index 0000000..4b6628b Binary files /dev/null and b/assets/social-preview/og.png differ diff --git a/assets/social-preview/og.svg b/assets/social-preview/og.svg new file mode 100644 index 0000000..adb4738 --- /dev/null +++ b/assets/social-preview/og.svg @@ -0,0 +1,21 @@ + + constitutional_runtime social preview + From Single-Agent OS to Constitutional Runtime: a governed runtime for persistent multi-agent AI. + + + constitutional_runtime + From Single-Agent OS + to Constitutional Runtime + A governed runtime for persistent multi-agent AI + + + CR - current truth + + CK - authority law + + MK - mission lifecycle + + + Public whitepaper + essay series + github.com/Chihvane + diff --git a/chapter1/final-draft-v3/en/index.md b/chapter1/final-draft-v3/en/index.md index a28a334..cbd6510 100644 --- a/chapter1/final-draft-v3/en/index.md +++ b/chapter1/final-draft-v3/en/index.md @@ -32,9 +32,8 @@ This PDF is the canonical source for both final formatting and final text. ## Platform Editions - [GitHub Pages edition](./github-pages.md): styled web edition with definition/example boxes preserved -- [Substack package](../../../.internal/unpublished/publishing/chapter-01/en/substack/): flattened paste edition plus figure assets -- [Hugging Face package](../../../.internal/unpublished/publishing/chapter-01/en/hugging-face/): README edition plus figure assets and canonical PDF -- [Conversion manifest](../../../.internal/unpublished/publishing/chapter-01/en/conversion-manifest.md): source hashes and conversion rules +- Substack and Hugging Face editions are prepared as platform-specific publication artifacts before release. Public readers should use the canonical PDF and GitHub Pages edition listed above. +- Conversion manifests are maintained as release engineering artifacts and are not part of the public navigation surface. ## Publication Rule diff --git a/chapter1/final-draft-v3/index.md b/chapter1/final-draft-v3/index.md index 45bcd0d..2ddc2d0 100644 --- a/chapter1/final-draft-v3/index.md +++ b/chapter1/final-draft-v3/index.md @@ -46,12 +46,8 @@ These PDFs are the canonical sources for final formatting and final text. - [Chinese GitHub Pages edition](./github-pages.md): styled web edition with definition/example boxes preserved - [English GitHub Pages edition](./en/github-pages.md): styled web edition with definition/example boxes preserved -- [Chinese Substack package](../../.internal/unpublished/publishing/chapter-01/substack/): flattened paste edition plus figure assets -- [English Substack package](../../.internal/unpublished/publishing/chapter-01/en/substack/): flattened paste edition plus figure assets -- [Chinese Hugging Face package](../../.internal/unpublished/publishing/chapter-01/hugging-face/): README edition plus figure assets and canonical PDF -- [English Hugging Face package](../../.internal/unpublished/publishing/chapter-01/en/hugging-face/): README edition plus figure assets and canonical PDF -- [Chinese conversion manifest](../../.internal/unpublished/publishing/chapter-01/conversion-manifest.md): source hashes and conversion rules -- [English conversion manifest](../../.internal/unpublished/publishing/chapter-01/en/conversion-manifest.md): source hashes and conversion rules +- Substack and Hugging Face editions are prepared as platform-specific publication artifacts before release. Public readers should use the canonical PDFs and GitHub Pages editions listed above. +- Conversion manifests are maintained as release engineering artifacts and are not part of the public navigation surface. ## Publication Rule diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..7c5e15a --- /dev/null +++ b/docs/README.md @@ -0,0 +1,20 @@ +--- +layout: page +title: Public Docs +--- + +# Public Docs + +This directory holds public-facing orientation pages for readers, citers, and release reviewers. It does not mirror private authoring material or operational traces. + +## Start Here + +- [Repository map](./repository-map.md) +- [Public publishing notes](./publishing.md) +- [Owner action checklist](./owner-actions.md) + +For the actual series text, start with: + +- [Chapter 1 version map](../chapter1/) +- [Chapter 2 version map](../chapter2/) +- [Chapter 1 reference evidence](../chapter1/references/) diff --git a/docs/owner-actions.md b/docs/owner-actions.md new file mode 100644 index 0000000..9c0a9a0 --- /dev/null +++ b/docs/owner-actions.md @@ -0,0 +1,43 @@ +--- +layout: page +title: Owner Action Checklist +--- + +# Owner Action Checklist + +Some discoverability actions are GitHub repository settings rather than files. They are documented here so the Owner can apply them after reviewing the branch. + +## Repository Description + +```bash +REPO=Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel + +gh repo edit "$REPO" \ + --description "Constitutional Runtime - a governed runtime architecture for persistent multi-agent AI: mission ownership, authority, evidence gates, audit receipts, and lawful closure as explicit runtime objects. Public whitepaper + essay series." +``` + +## Topics + +```bash +REPO=Chihvane/persistent--multi-agent--constitutional-runtime-kernel--mission-kernel + +gh repo edit "$REPO" \ + --add-topic ai-agents \ + --add-topic multi-agent-systems \ + --add-topic ai-governance \ + --add-topic ai-safety \ + --add-topic llm \ + --add-topic agent-architecture \ + --add-topic agentic-ai \ + --add-topic whitepaper \ + --add-topic ai-alignment \ + --add-topic runtime-architecture +``` + +## Social Preview + +TODO(owner): In GitHub repository settings, upload `assets/social-preview/og.png` as the custom social preview image. + +## Releases + +TODO(owner): After reviewing release assets, create tagged GitHub Releases for published chapters. Chapter 1 can attach both final PDFs. Chapter 2 should wait until the Owner decides whether a canonical PDF is needed for v7.3. diff --git a/docs/publishing.md b/docs/publishing.md new file mode 100644 index 0000000..aef8aab --- /dev/null +++ b/docs/publishing.md @@ -0,0 +1,25 @@ +--- +layout: page +title: Public Publishing Notes +--- + +# Public Publishing Notes + +This page records the public-facing publication status of the repository. It avoids internal authoring paths and points readers to stable public artifacts. + +## Published Chapters + +| Chapter | Status | Canonical / Source Artifacts | +|---|---|---| +| Chapter 1 | Final v3, Chinese and English | [Version map](../chapter1/final-draft-v3/), [Chinese PDF](../chapter1/final-draft-v3/package-v3/chapter1.pdf), [English PDF](../chapter1/final-draft-v3/package-v3-en/chapter1.pdf) | +| Chapter 2 | Final v7.3, Chinese source package | [Version map](../chapter2/final-draft-v7.3/), [Markdown](../chapter2/final-draft-v7.3/package-v7.3/chapter2.md), [HTML](../chapter2/final-draft-v7.3/package-v7.3/chapter2.html) | + +## Current Canonical Rule + +For Chapter 1, each language edition's PDF is the final authority for both text and layout. + +For Chapter 2 v7.3, the supplied HTML source and repository-readable Markdown package are published together. A future PDF can be added as the layout authority without changing the source package identity. + +## Chapter 2 English Translation + +Chapter 2 English translation is intentionally not part of this layout optimization pass. Until the Owner approves an English edition, the Chinese v7.3 package remains the source of record. diff --git a/docs/repository-map.md b/docs/repository-map.md new file mode 100644 index 0000000..eadc7d3 --- /dev/null +++ b/docs/repository-map.md @@ -0,0 +1,50 @@ +--- +layout: page +title: Repository Map +--- + +# Repository Map + +`constitutional_runtime` is a public documentation, essay, diagram, evidence, and whitepaper repository. It is not the private implementation source tree. + +```text +. +├── README.md +├── README.en.md +├── README.zh-CN.md +├── LICENSE +├── LICENSE-CODE +├── CITATION.cff +├── .github/ +├── assets/ +│ └── social-preview/ +├── docs/ +├── chapter1/ +│ ├── README.md +│ ├── README.zh-CN.md +│ ├── final-draft-v3/ +│ │ ├── package-v3/ +│ │ ├── package-v3-en/ +│ │ ├── github-pages.md +│ │ └── en/ +│ └── references/ +├── chapter2/ +│ ├── README.md +│ ├── README.zh-CN.md +│ └── final-draft-v7.3/ +│ ├── package-v7.3/ +│ └── github-pages.md +└── .internal/ +``` + +## Public Entries + +- Root READMEs provide language selection, current thesis, reading order, license, and citation. +- `chapter1/` and `chapter2/` hold published chapter packages and version maps. +- `docs/` holds reader-facing orientation pages. +- `assets/` holds public visual assets such as the social preview image. +- `.github/` holds issue templates, PR template, CODEOWNERS, and Actions workflows. + +## Private Boundary + +`.internal/` remains private-by-design authoring and release-support material. Public pages should not link into it. If internal material becomes public, publish a sanitized public copy instead of exposing the internal path.