Optimize public repository layout

.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

.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

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/."