diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 243fd58..a473954 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,18 +1,20 @@ ## Summary -Brief description of the changes. + -## Type of Change +## Changes -- [ ] Bug fix -- [ ] New feature -- [ ] Documentation update -- [ ] Refactoring -- [ ] CI/CD improvement +- + +## Testing + +- [ ] Existing tests pass +- [ ] New tests added for new functionality (if applicable) +- [ ] Manual verification performed ## Checklist -- [ ] My code follows the project's style guidelines -- [ ] I have performed a self-review -- [ ] I have added tests that prove my fix/feature works -- [ ] New and existing tests pass locally \ No newline at end of file +- [ ] Follows existing code style and patterns +- [ ] No secrets, credentials, or personal data included +- [ ] seed.yaml updated (if produces/consumes edges changed) +- [ ] CLAUDE.md changes auto-generated (run `organvm context sync` if needed) diff --git a/.github/workflows/ci-minimal.yml b/.github/workflows/ci-minimal.yml index 825172b..555dc2a 100644 --- a/.github/workflows/ci-minimal.yml +++ b/.github/workflows/ci-minimal.yml @@ -10,7 +10,7 @@ jobs: validate: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 - name: Check README exists run: | diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml new file mode 100644 index 0000000..71fa569 --- /dev/null +++ b/.github/workflows/stale.yml @@ -0,0 +1,31 @@ +name: Stale Issues and PRs + +on: + schedule: + - cron: '0 9 * * 1' + workflow_dispatch: + +permissions: + issues: write + pull-requests: write + +jobs: + stale: + runs-on: ubuntu-latest + steps: + - uses: actions/stale@v9 + with: + stale-issue-message: > + This issue has been automatically marked as stale because it has not + had recent activity. It will be closed in 14 days if no further + activity occurs. + stale-pr-message: > + This PR has been automatically marked as stale because it has not + had recent activity. It will be closed in 14 days if no further + activity occurs. + days-before-stale: 60 + days-before-close: 14 + exempt-issue-labels: 'pinned,evergreen,omega,blocked' + exempt-pr-labels: 'pinned,evergreen,work-in-progress' + stale-issue-label: 'stale' + stale-pr-label: 'stale' diff --git a/AGENTS.md b/AGENTS.md index 8f2154e..c3a339a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -33,5 +33,5 @@ This repo participates in the **ORGAN-I (Theory)** swarm. - Adhere to unidirectional flow: I→II→III - Never commit secrets or credentials -*Last synced: 2026-02-24T12:41:28Z* +*Last synced: 2026-03-21T13:21:03Z* diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..5cf2bfb --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog + +All notable changes to the meta-organvm org-level community health files. + +## [Unreleased] + +### Added +- Initial community health files (README, CONTRIBUTING, CODE_OF_CONDUCT, templates) +- Organization-level CI workflow templates +- organ-aesthetic.yaml visual identity cascade diff --git a/CLAUDE.md b/CLAUDE.md index eb945f3..d848be9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,20 +1,156 @@ ## System Context (auto-generated — do not edit) -**Organ:** ORGAN-I (Theory) | **Tier:** infrastructure | **Status:** LOCAL -**Org:** `unknown` | **Repo:** `.github` +**Organ:** ORGAN-I (Theory) | **Tier:** infrastructure | **Status:** GRADUATED +**Org:** `meta-organvm` | **Repo:** `.github` ### Edges -- **Produces** → `unknown`: unknown (event: `distribution-completed`) -- **Produces** → `unknown`: unknown (event: `press-release`) -- **Produces** → `unknown`: unknown (event: `grant-update`) -- **Produces** → `unknown`: unknown (event: `newsletter-published`) +- **Produces** → `ORGAN-IV, ORGAN-V`: unspecified (event: `distribution-completed`) +- **Produces** → `unspecified`: unspecified (event: `press-release`) +- **Produces** → `unspecified`: unspecified (event: `grant-update`) +- **Produces** → `ORGAN-V`: unspecified (event: `newsletter-published`) ### Siblings in Theory -`recursive-engine--generative-entity`, `organon-noumenon--ontogenetic-morphe`, `auto-revision-epistemic-engine`, `narratological-algorithmic-lenses`, `call-function--ontological`, `sema-metra--alchemica-mundi`, `system-governance-framework`, `cognitive-archaelogy-tribunal`, `a-recursive-root`, `radix-recursiva-solve-coagula-redi`, `nexus--babel-alexandria-`, `reverse-engine-recursive-run`, `4-ivi374-F0Rivi4`, `cog-init-1-0-`, `collective-persona-operations` ... and 4 more +`recursive-engine--generative-entity`, `organon-noumenon--ontogenetic-morphe`, `auto-revision-epistemic-engine`, `narratological-algorithmic-lenses`, `call-function--ontological`, `sema-metra--alchemica-mundi`, `cognitive-archaelogy-tribunal`, `a-recursive-root`, `radix-recursiva-solve-coagula-redi`, `nexus--babel-alexandria`, `4-ivi374-F0Rivi4`, `cog-init-1-0-`, `linguistic-atomization-framework`, `my-knowledge-base`, `scalable-lore-expert` ... and 5 more ### Governance - Foundational theory layer. No upstream dependencies. -*Last synced: 2026-02-24T12:41:28Z* +*Last synced: 2026-03-21T13:21:03Z* + +## Session Review Protocol + +At the end of each session that produces or modifies files: +1. Run `organvm session review --latest` to get a session summary +2. Check for unimplemented plans: `organvm session plans --project .` +3. Export significant sessions: `organvm session export --slug ` +4. Run `organvm prompts distill --dry-run` to detect uncovered operational patterns + +Transcripts are on-demand (never committed): +- `organvm session transcript ` — conversation summary +- `organvm session transcript --unabridged` — full audit trail +- `organvm session prompts ` — human prompts only + + +## Active Directives + +| Scope | Phase | Name | Description | +|-------|-------|------|-------------| +| organ | any | commit-and-release-workflow | Commit & Release Workflow | +| organ | any | session-state-management | session-state-management | +| organ | any | submodule-sync-protocol | submodule-sync-protocol | +| system | any | prompting-standards | Prompting Standards | +| system | any | research-standards-bibliography | APPENDIX: Research Standards Bibliography | +| system | any | phase-closing-and-forward-plan | METADOC: Phase-Closing Commemoration & Forward Attack Plan | +| system | any | research-standards | METADOC: Architectural Typology & Research Standards | +| system | any | sop-ecosystem | METADOC: SOP Ecosystem — Taxonomy, Inventory & Coverage | +| system | any | autonomous-content-syndication | SOP: Autonomous Content Syndication (The Broadcast Protocol) | +| system | any | autopoietic-systems-diagnostics | SOP: Autopoietic Systems Diagnostics (The Mirror of Eternity) | +| system | any | background-task-resilience | background-task-resilience | +| system | any | cicd-resilience-and-recovery | SOP: CI/CD Pipeline Resilience & Recovery | +| system | any | community-event-facilitation | SOP: Community Event Facilitation (The Dialectic Crucible) | +| system | any | context-window-conservation | context-window-conservation | +| system | any | conversation-to-content-pipeline | SOP — Conversation-to-Content Pipeline | +| system | any | cross-agent-handoff | SOP: Cross-Agent Session Handoff | +| system | any | cross-channel-publishing-metrics | SOP: Cross-Channel Publishing Metrics (The Echo Protocol) | +| system | any | data-migration-and-backup | SOP: Data Migration and Backup Protocol (The Memory Vault) | +| system | any | document-audit-feature-extraction | SOP: Document Audit & Feature Extraction | +| system | any | dynamic-lens-assembly | SOP: Dynamic Lens Assembly | +| system | any | essay-publishing-and-distribution | SOP: Essay Publishing & Distribution | +| system | any | formal-methods-applied-protocols | SOP: Formal Methods Applied Protocols | +| system | any | formal-methods-master-taxonomy | SOP: Formal Methods Master Taxonomy (The Blueprint of Proof) | +| system | any | formal-methods-tla-pluscal | SOP: Formal Methods — TLA+ and PlusCal Verification (The Blueprint Verifier) | +| system | any | generative-art-deployment | SOP: Generative Art Deployment (The Gallery Protocol) | +| system | any | market-gap-analysis | SOP: Full-Breath Market-Gap Analysis & Defensive Parrying | +| system | any | mcp-server-fleet-management | SOP: MCP Server Fleet Management (The Server Protocol) | +| system | any | multi-agent-swarm-orchestration | SOP: Multi-Agent Swarm Orchestration (The Polymorphic Swarm) | +| system | any | network-testament-protocol | SOP: Network Testament Protocol (The Mirror Protocol) | +| system | any | open-source-licensing-and-ip | SOP: Open Source Licensing and IP (The Commons Protocol) | +| system | any | performance-interface-design | SOP: Performance Interface Design (The Stage Protocol) | +| system | any | pitch-deck-rollout | SOP: Pitch Deck Generation & Rollout | +| system | any | polymorphic-agent-testing | SOP: Polymorphic Agent Testing (The Adversarial Protocol) | +| system | any | promotion-and-state-transitions | SOP: Promotion & State Transitions | +| system | any | recursive-study-feedback | SOP: Recursive Study & Feedback Loop (The Ouroboros) | +| system | any | repo-onboarding-and-habitat-creation | SOP: Repo Onboarding & Habitat Creation | +| system | any | research-to-implementation-pipeline | SOP: Research-to-Implementation Pipeline (The Gold Path) | +| system | any | security-and-accessibility-audit | SOP: Security & Accessibility Audit | +| system | any | session-self-critique | session-self-critique | +| system | any | smart-contract-audit-and-legal-wrap | SOP: Smart Contract Audit and Legal Wrap (The Ledger Protocol) | +| system | any | source-evaluation-and-bibliography | SOP: Source Evaluation & Annotated Bibliography (The Refinery) | +| system | any | stranger-test-protocol | SOP: Stranger Test Protocol | +| system | any | strategic-foresight-and-futures | SOP: Strategic Foresight & Futures (The Telescope) | +| system | any | styx-pipeline-traversal | SOP: Styx Pipeline Traversal (The 7-Organ Transmutation) | +| system | any | system-dashboard-telemetry | SOP: System Dashboard Telemetry (The Panopticon Protocol) | +| system | any | the-descent-protocol | the-descent-protocol | +| system | any | the-membrane-protocol | the-membrane-protocol | +| system | any | theoretical-concept-versioning | SOP: Theoretical Concept Versioning (The Epistemic Protocol) | +| system | any | theory-to-concrete-gate | theory-to-concrete-gate | +| system | any | typological-hermeneutic-analysis | SOP: Typological & Hermeneutic Analysis (The Archaeology) | +| unknown | any | SOP-001-vector-pipeline-activation | SOP-001: Vector Pipeline Activation | +| unknown | any | cicd-resilience | SOP: CI/CD Pipeline Resilience & Recovery | +| unknown | any | document-audit-feature-extraction | SOP: Document Audit & Feature Extraction v2.0 | +| unknown | any | ira-grade-norming | SOP: Diagnostic Inter-Rater Agreement (IRA) Grade Norming | +| unknown | any | ira-grade-norming | ira-grade-norming | +| unknown | any | pitch-deck-rollout | SOP: Pitch Deck Generation & Rollout | + +Linked skills: cicd-resilience-and-recovery, continuous-learning-agent, cross-agent-handoff, evaluation-to-growth, genesis-dna, multi-agent-workforce-planner, promotion-and-state-transitions, quality-gate-baseline-calibration, repo-onboarding-and-habitat-creation, session-self-critique, structural-integrity-audit + + +**Prompting (Anthropic)**: context 200K tokens, format: XML tags, thinking: extended thinking (budget_tokens) + + +## Entity Identity (Ontologia) + +**UID:** `ent_repo_01KKKX3RVH13015KN8GT0VY8VE` | **Matched by:** primary_name + +Resolve: `organvm ontologia resolve .github` | History: `organvm ontologia history ent_repo_01KKKX3RVH13015KN8GT0VY8VE` + + +## Live System Variables (Ontologia) + +| Variable | Value | Scope | Updated | +|----------|-------|-------|---------| +| `active_repos` | 62 | global | 2026-03-21 | +| `archived_repos` | 53 | global | 2026-03-21 | +| `ci_workflows` | 104 | global | 2026-03-21 | +| `code_files` | 23121 | global | 2026-03-21 | +| `dependency_edges` | 55 | global | 2026-03-21 | +| `operational_organs` | 8 | global | 2026-03-21 | +| `published_essays` | 0 | global | 2026-03-21 | +| `repos_with_tests` | 47 | global | 2026-03-21 | +| `sprints_completed` | 0 | global | 2026-03-21 | +| `test_files` | 4337 | global | 2026-03-21 | +| `total_organs` | 8 | global | 2026-03-21 | +| `total_repos` | 116 | global | 2026-03-21 | +| `total_words_formatted` | 740,907 | global | 2026-03-21 | +| `total_words_numeric` | 740907 | global | 2026-03-21 | +| `total_words_short` | 741K+ | global | 2026-03-21 | + +Metrics: 9 registered | Observations: 8632 recorded +Resolve: `organvm ontologia status` | Refresh: `organvm refresh` + + +## System Density (auto-generated) + +AMMOI: 54% | Edges: 28 | Tensions: 33 | Clusters: 5 | Adv: 3 | Events(24h): 14977 +Structure: 8 organs / 117 repos / 1654 components (depth 17) | Inference: 98% | Organs: META-ORGANVM:66%, ORGAN-I:55%, ORGAN-II:47%, ORGAN-III:56% +4 more +Last pulse: 2026-03-21T13:20:54 | Δ24h: n/a | Δ7d: n/a + + +## Dialect Identity (Trivium) + +**Dialect:** FORMAL_LOGIC | **Classical Parallel:** Logic | **Translation Role:** The Grammar — defines well-formedness in any dialect + +Strongest translations: III (formal), IV (formal), META (formal) + +Scan: `organvm trivium scan I ` | Matrix: `organvm trivium matrix` | Synthesize: `organvm trivium synthesize` + + + +## ⚡ Conductor OS Integration +This repository is a managed component of the ORGANVM meta-workspace. +- **Orchestration:** Use `conductor patch` for system status and work queue. +- **Lifecycle:** Follow the `FRAME -> SHAPE -> BUILD -> PROVE` workflow. +- **Governance:** Promotions are managed via `conductor wip promote`. +- **Intelligence:** Conductor MCP tools are available for routing and mission synthesis. diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..600e2dd --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1 @@ +* @4444j99 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d8e6870..ef02284 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -42,10 +42,22 @@ Changes to meta-organvm affect all 7 organ organizations. Proposals require broa - Python: PEP 8, type hints, f-strings - Tests required for all new functionality - Commit messages: imperative mood, <72 chars title +- README structure and depth must follow [README standards](README_STANDARDS.md) + +## First-Time Contributors + +Look for issues labeled **`good first issue`** across our repositories: + +- [organvm-engine](https://github.com/meta-organvm/organvm-engine/labels/good%20first%20issue) — CLI enhancements, type hints, shell completions +- [organvm-corpvs-testamentvm](https://github.com/meta-organvm/organvm-corpvs-testamentvm/labels/good%20first%20issue) — documentation, diagrams, concordance +- [schema-definitions](https://github.com/meta-organvm/schema-definitions/labels/good%20first%20issue) — schema examples, validation improvements +- [system-dashboard](https://github.com/meta-organvm/system-dashboard/labels/good%20first%20issue) — UI improvements, new routes +- [organvm-ontologia](https://github.com/meta-organvm/organvm-ontologia/labels/good%20first%20issue) — entity resolution, sensing layer ## Getting Help -- Open an Issue for questions +- **[GitHub Discussions](https://github.com/meta-organvm/organvm-corpvs-testamentvm/discussions)** — ask questions, propose ideas, share feedback +- **Issues** — report bugs or request features on the relevant repository - Check existing documentation in each repo's README --- diff --git a/FUNDING.yml b/FUNDING.yml new file mode 100644 index 0000000..87619e7 --- /dev/null +++ b/FUNDING.yml @@ -0,0 +1 @@ +github: [4444J99] diff --git a/GEMINI.md b/GEMINI.md index eb945f3..9939623 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -1,20 +1,156 @@ ## System Context (auto-generated — do not edit) -**Organ:** ORGAN-I (Theory) | **Tier:** infrastructure | **Status:** LOCAL -**Org:** `unknown` | **Repo:** `.github` +**Organ:** ORGAN-I (Theory) | **Tier:** infrastructure | **Status:** GRADUATED +**Org:** `meta-organvm` | **Repo:** `.github` ### Edges -- **Produces** → `unknown`: unknown (event: `distribution-completed`) -- **Produces** → `unknown`: unknown (event: `press-release`) -- **Produces** → `unknown`: unknown (event: `grant-update`) -- **Produces** → `unknown`: unknown (event: `newsletter-published`) +- **Produces** → `ORGAN-IV, ORGAN-V`: unspecified (event: `distribution-completed`) +- **Produces** → `unspecified`: unspecified (event: `press-release`) +- **Produces** → `unspecified`: unspecified (event: `grant-update`) +- **Produces** → `ORGAN-V`: unspecified (event: `newsletter-published`) ### Siblings in Theory -`recursive-engine--generative-entity`, `organon-noumenon--ontogenetic-morphe`, `auto-revision-epistemic-engine`, `narratological-algorithmic-lenses`, `call-function--ontological`, `sema-metra--alchemica-mundi`, `system-governance-framework`, `cognitive-archaelogy-tribunal`, `a-recursive-root`, `radix-recursiva-solve-coagula-redi`, `nexus--babel-alexandria-`, `reverse-engine-recursive-run`, `4-ivi374-F0Rivi4`, `cog-init-1-0-`, `collective-persona-operations` ... and 4 more +`recursive-engine--generative-entity`, `organon-noumenon--ontogenetic-morphe`, `auto-revision-epistemic-engine`, `narratological-algorithmic-lenses`, `call-function--ontological`, `sema-metra--alchemica-mundi`, `cognitive-archaelogy-tribunal`, `a-recursive-root`, `radix-recursiva-solve-coagula-redi`, `nexus--babel-alexandria`, `4-ivi374-F0Rivi4`, `cog-init-1-0-`, `linguistic-atomization-framework`, `my-knowledge-base`, `scalable-lore-expert` ... and 5 more ### Governance - Foundational theory layer. No upstream dependencies. -*Last synced: 2026-02-24T12:41:28Z* +*Last synced: 2026-03-21T13:21:03Z* + +## Session Review Protocol + +At the end of each session that produces or modifies files: +1. Run `organvm session review --latest` to get a session summary +2. Check for unimplemented plans: `organvm session plans --project .` +3. Export significant sessions: `organvm session export --slug ` +4. Run `organvm prompts distill --dry-run` to detect uncovered operational patterns + +Transcripts are on-demand (never committed): +- `organvm session transcript ` — conversation summary +- `organvm session transcript --unabridged` — full audit trail +- `organvm session prompts ` — human prompts only + + +## Active Directives + +| Scope | Phase | Name | Description | +|-------|-------|------|-------------| +| organ | any | commit-and-release-workflow | Commit & Release Workflow | +| organ | any | session-state-management | session-state-management | +| organ | any | submodule-sync-protocol | submodule-sync-protocol | +| system | any | prompting-standards | Prompting Standards | +| system | any | research-standards-bibliography | APPENDIX: Research Standards Bibliography | +| system | any | phase-closing-and-forward-plan | METADOC: Phase-Closing Commemoration & Forward Attack Plan | +| system | any | research-standards | METADOC: Architectural Typology & Research Standards | +| system | any | sop-ecosystem | METADOC: SOP Ecosystem — Taxonomy, Inventory & Coverage | +| system | any | autonomous-content-syndication | SOP: Autonomous Content Syndication (The Broadcast Protocol) | +| system | any | autopoietic-systems-diagnostics | SOP: Autopoietic Systems Diagnostics (The Mirror of Eternity) | +| system | any | background-task-resilience | background-task-resilience | +| system | any | cicd-resilience-and-recovery | SOP: CI/CD Pipeline Resilience & Recovery | +| system | any | community-event-facilitation | SOP: Community Event Facilitation (The Dialectic Crucible) | +| system | any | context-window-conservation | context-window-conservation | +| system | any | conversation-to-content-pipeline | SOP — Conversation-to-Content Pipeline | +| system | any | cross-agent-handoff | SOP: Cross-Agent Session Handoff | +| system | any | cross-channel-publishing-metrics | SOP: Cross-Channel Publishing Metrics (The Echo Protocol) | +| system | any | data-migration-and-backup | SOP: Data Migration and Backup Protocol (The Memory Vault) | +| system | any | document-audit-feature-extraction | SOP: Document Audit & Feature Extraction | +| system | any | dynamic-lens-assembly | SOP: Dynamic Lens Assembly | +| system | any | essay-publishing-and-distribution | SOP: Essay Publishing & Distribution | +| system | any | formal-methods-applied-protocols | SOP: Formal Methods Applied Protocols | +| system | any | formal-methods-master-taxonomy | SOP: Formal Methods Master Taxonomy (The Blueprint of Proof) | +| system | any | formal-methods-tla-pluscal | SOP: Formal Methods — TLA+ and PlusCal Verification (The Blueprint Verifier) | +| system | any | generative-art-deployment | SOP: Generative Art Deployment (The Gallery Protocol) | +| system | any | market-gap-analysis | SOP: Full-Breath Market-Gap Analysis & Defensive Parrying | +| system | any | mcp-server-fleet-management | SOP: MCP Server Fleet Management (The Server Protocol) | +| system | any | multi-agent-swarm-orchestration | SOP: Multi-Agent Swarm Orchestration (The Polymorphic Swarm) | +| system | any | network-testament-protocol | SOP: Network Testament Protocol (The Mirror Protocol) | +| system | any | open-source-licensing-and-ip | SOP: Open Source Licensing and IP (The Commons Protocol) | +| system | any | performance-interface-design | SOP: Performance Interface Design (The Stage Protocol) | +| system | any | pitch-deck-rollout | SOP: Pitch Deck Generation & Rollout | +| system | any | polymorphic-agent-testing | SOP: Polymorphic Agent Testing (The Adversarial Protocol) | +| system | any | promotion-and-state-transitions | SOP: Promotion & State Transitions | +| system | any | recursive-study-feedback | SOP: Recursive Study & Feedback Loop (The Ouroboros) | +| system | any | repo-onboarding-and-habitat-creation | SOP: Repo Onboarding & Habitat Creation | +| system | any | research-to-implementation-pipeline | SOP: Research-to-Implementation Pipeline (The Gold Path) | +| system | any | security-and-accessibility-audit | SOP: Security & Accessibility Audit | +| system | any | session-self-critique | session-self-critique | +| system | any | smart-contract-audit-and-legal-wrap | SOP: Smart Contract Audit and Legal Wrap (The Ledger Protocol) | +| system | any | source-evaluation-and-bibliography | SOP: Source Evaluation & Annotated Bibliography (The Refinery) | +| system | any | stranger-test-protocol | SOP: Stranger Test Protocol | +| system | any | strategic-foresight-and-futures | SOP: Strategic Foresight & Futures (The Telescope) | +| system | any | styx-pipeline-traversal | SOP: Styx Pipeline Traversal (The 7-Organ Transmutation) | +| system | any | system-dashboard-telemetry | SOP: System Dashboard Telemetry (The Panopticon Protocol) | +| system | any | the-descent-protocol | the-descent-protocol | +| system | any | the-membrane-protocol | the-membrane-protocol | +| system | any | theoretical-concept-versioning | SOP: Theoretical Concept Versioning (The Epistemic Protocol) | +| system | any | theory-to-concrete-gate | theory-to-concrete-gate | +| system | any | typological-hermeneutic-analysis | SOP: Typological & Hermeneutic Analysis (The Archaeology) | +| unknown | any | SOP-001-vector-pipeline-activation | SOP-001: Vector Pipeline Activation | +| unknown | any | cicd-resilience | SOP: CI/CD Pipeline Resilience & Recovery | +| unknown | any | document-audit-feature-extraction | SOP: Document Audit & Feature Extraction v2.0 | +| unknown | any | ira-grade-norming | SOP: Diagnostic Inter-Rater Agreement (IRA) Grade Norming | +| unknown | any | ira-grade-norming | ira-grade-norming | +| unknown | any | pitch-deck-rollout | SOP: Pitch Deck Generation & Rollout | + +Linked skills: cicd-resilience-and-recovery, continuous-learning-agent, cross-agent-handoff, evaluation-to-growth, genesis-dna, multi-agent-workforce-planner, promotion-and-state-transitions, quality-gate-baseline-calibration, repo-onboarding-and-habitat-creation, session-self-critique, structural-integrity-audit + + +**Prompting (Google)**: context 1M tokens (Gemini 1.5 Pro), format: markdown, thinking: thinking mode (thinkingConfig) + + +## Entity Identity (Ontologia) + +**UID:** `ent_repo_01KKKX3RVH13015KN8GT0VY8VE` | **Matched by:** primary_name + +Resolve: `organvm ontologia resolve .github` | History: `organvm ontologia history ent_repo_01KKKX3RVH13015KN8GT0VY8VE` + + +## Live System Variables (Ontologia) + +| Variable | Value | Scope | Updated | +|----------|-------|-------|---------| +| `active_repos` | 62 | global | 2026-03-21 | +| `archived_repos` | 53 | global | 2026-03-21 | +| `ci_workflows` | 104 | global | 2026-03-21 | +| `code_files` | 23121 | global | 2026-03-21 | +| `dependency_edges` | 55 | global | 2026-03-21 | +| `operational_organs` | 8 | global | 2026-03-21 | +| `published_essays` | 0 | global | 2026-03-21 | +| `repos_with_tests` | 47 | global | 2026-03-21 | +| `sprints_completed` | 0 | global | 2026-03-21 | +| `test_files` | 4337 | global | 2026-03-21 | +| `total_organs` | 8 | global | 2026-03-21 | +| `total_repos` | 116 | global | 2026-03-21 | +| `total_words_formatted` | 740,907 | global | 2026-03-21 | +| `total_words_numeric` | 740907 | global | 2026-03-21 | +| `total_words_short` | 741K+ | global | 2026-03-21 | + +Metrics: 9 registered | Observations: 8632 recorded +Resolve: `organvm ontologia status` | Refresh: `organvm refresh` + + +## System Density (auto-generated) + +AMMOI: 54% | Edges: 28 | Tensions: 33 | Clusters: 5 | Adv: 3 | Events(24h): 14977 +Structure: 8 organs / 117 repos / 1654 components (depth 17) | Inference: 98% | Organs: META-ORGANVM:66%, ORGAN-I:55%, ORGAN-II:47%, ORGAN-III:56% +4 more +Last pulse: 2026-03-21T13:20:54 | Δ24h: n/a | Δ7d: n/a + + +## Dialect Identity (Trivium) + +**Dialect:** FORMAL_LOGIC | **Classical Parallel:** Logic | **Translation Role:** The Grammar — defines well-formedness in any dialect + +Strongest translations: III (formal), IV (formal), META (formal) + +Scan: `organvm trivium scan I ` | Matrix: `organvm trivium matrix` | Synthesize: `organvm trivium synthesize` + + + +## ⚡ Conductor OS Integration +This repository is a managed component of the ORGANVM meta-workspace. +- **Orchestration:** Use `conductor patch` for system status and work queue. +- **Lifecycle:** Follow the `FRAME -> SHAPE -> BUILD -> PROVE` workflow. +- **Governance:** Promotions are managed via `conductor wip promote`. +- **Intelligence:** Conductor MCP tools are available for routing and mission synthesis. diff --git a/GITHUB_APP_CONFIG.md b/GITHUB_APP_CONFIG.md new file mode 100644 index 0000000..e223b16 --- /dev/null +++ b/GITHUB_APP_CONFIG.md @@ -0,0 +1,69 @@ +# GitHub App Configuration: meta-organvm-cross-org + +**Last Updated:** 2026-02-26T18:29:54.891Z + +## Overview + +The `meta-organvm-cross-org` GitHub App enables cross-organization automation and CI/CD orchestration across the 8-organ system enterprise. + +## App Credentials + +**All credentials stored in 1Password → GitHub-Tokens vault** + +| Field | Value | 1Password Reference | +|-------|-------|-----------| +| **App ID** | `2958047` | op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/app_id | +| **Client ID** | `Iv23liN5op3fxVRtJgAp` | op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/client_id | +| **Client Secret** | `9aad30e3f85aae0a7fee961abc8d8519644415a4` | op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/client_secret | +| **Private Key** | (See 1Password) | op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/private_key | +| **Webhook Secret** | `ea504da70f6cc2cd73c47b63330fd61d3e812374f4a43a4126d698ba13bc1b2f` | op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/webhook_secret | + +## Webhook Configuration + +| Setting | Value | +|---------|-------| +| **Webhook URL** | `https://symbolistical-amiya-mitigable.ngrok-free.dev/github/webhook` | +| **Webhook Secret** | `ea504da70f6cc2cd73c47b63330fd61d3e812374f4a43a4126d698ba13bc1b2f` | +| **SSL Verification** | Enabled | +| **Active** | Yes | + +## Subscribed Events + +- `push` +- `pull_request` +- `workflow_run` + +## Installation Status + +| Organization | Installation ID | Status | +|--------------|-----------------|--------| +| `meta-organvm` | `112680405` | ✅ Installed | +| `organvm-i-theoria` | TBD | ⏳ Pending | +| `organvm-ii-poiesis` | TBD | ⏳ Pending | +| `organvm-iii-ergon` | TBD | ⏳ Pending | +| `organvm-iv-taxis` | TBD | ⏳ Pending | +| `organvm-v-logos` | TBD | ⏳ Pending | +| `organvm-vi-koinonia` | TBD | ⏳ Pending | +| `organvm-vii-kerygma` | TBD | ⏳ Pending | + +## Environment Variables + +```bash +GITHUB_APP_ID=2958047 +GITHUB_APP_CLIENT_ID=Iv23liN5op3fxVRtJgAp +GITHUB_WEBHOOK_SECRET=ea504da70f6cc2cd73c47b63330fd61d3e812374f4a43a4126d698ba13bc1b2f +``` + +## Retrieving Credentials from 1Password + +```bash +op read "op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/app_id" +op read "op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/client_secret" +op read "op://GitHub-Tokens/GitHub App: meta-organvm-cross-org/private_key" +``` + +## References + +- GitHub App Settings: https://github.com/organizations/meta-organvm/settings/apps/meta-organvm-cross-org +- Webhook Handler: `system-dashboard/src/dashboard/routes/github_app.py` +- 1Password Vault: `GitHub-Tokens` → `GitHub App: meta-organvm-cross-org` diff --git a/README.md b/README.md index 533f996..f73aacb 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,8 @@ # .github -Organization profile and community health files +Organization profile and community health files. + +## Included Governance Assets + +- Issue templates and PR template defaults +- Organization-level workflows +- [README standards (canonical)](README_STANDARDS.md) diff --git a/README_STANDARDS.md b/README_STANDARDS.md new file mode 100644 index 0000000..384cb4b --- /dev/null +++ b/README_STANDARDS.md @@ -0,0 +1,170 @@ +# README Standards + +Canonical README policy for all ORGANVM repositories across all organs. + +## Scope + +This file is the source of truth for: + +- README structure and depth by tier +- Organ-specific required sections +- Minimum quality rubric used for audits +- Minimum community-health and root-hygiene requirements tied to README quality + +Derived from the system corpus standards: + +- `organvm-corpvs-testamentvm/docs/standards/10-repository-standards.md` +- `organvm-corpvs-testamentvm/docs/planning/01-readme-audit-framework.md` +- `organvm-corpvs-testamentvm/docs/planning/03-per-organ-readme-templates.md` + +## Universal README Model + +Every README should follow progressive disclosure: + +1. Hero: title, key badges, one-line hook, quick navigation +2. Value: problem statement / purpose +3. Action: setup, usage, examples +4. Context: cross-references, contributing, license, author + +## Tier Requirements + +| Tier | Target | Minimum | +|------|--------|---------| +| Flagship | 3,000+ words | 12+ sections, complete 4-layer model | +| Standard | 1,000+ words | 8+ sections, complete 4-layer model | +| Stub | 200+ words | title, purpose, status, parent links | +| Archive | 50+ words | archive notice + redirect | + +## Organ-Specific Required Sections + +### ORGAN-I (Theory) +- Problem Statement +- Core Concepts +- Related Work +- Installation or Usage +- Examples +- Downstream Implementation +- Validation +- Roadmap +- Cross-References + +### ORGAN-II (Art) +- Artistic Purpose +- Conceptual Approach +- Technical Overview +- Installation +- Working Examples or Demos +- Theory Implemented +- Portfolio or Exhibition Context +- Contributing + +### ORGAN-III (Commerce) +- Product Overview +- Value Proposition +- Business Model +- Technical Architecture +- Getting Started +- Case Study +- Metrics and Proof +- Support and Governance + +### ORGAN-IV (Orchestration) +- Orchestration Purpose +- Registry Overview +- Governance Rules +- How It Works +- Key Concepts (promotion/dependency/validation) +- Concrete Example Flow +- Contributing to Governance + +### ORGAN-V (Public Process) +- Publication Purpose +- Publishing Guidelines +- Structure/Frontmatter Requirements +- Index or Corpus Navigation +- Subscription/Distribution +- Contributing +- Archive + +### ORGAN-VI (Community) +- Community Purpose +- Participation Model +- Community Guidelines +- Archive Structure +- Access Model +- Contributing + +### ORGAN-VII (Marketing) +- Distribution Strategy +- Audience Target +- Content Types +- Metrics +- Channels +- Publishing Calendar +- Templates or Playbooks + +## README Quality Rubric (0-100) + +### Existence and Accessibility (0-20) +- README exists in root +- clear title + one-line description +- table of contents/navigation +- readable formatting + +### Content Completeness (0-40) +- explicit problem statement +- complete setup/install instructions +- two or more working examples (where applicable) +- dependencies documented +- contributing guidance present + +### Accuracy and Currency (0-20) +- links valid +- examples run +- docs match implementation +- freshness timestamp or clear status + +### Portfolio Relevance (0-20) +- why repo exists is explicit +- connection to larger system is explicit +- features/value proposition clear +- evidence or impact signals present + +## Root Hygiene and Community Files + +At minimum, each active repo should include: + +- `README.md` +- `LICENSE` +- `.gitignore` +- `.github/CONTRIBUTING.md` (or org-level fallback) +- `.github/SECURITY.md` (or org-level fallback) +- `.github/CODE_OF_CONDUCT.md` (or org-level fallback) + +Flagship and Standard repos should also include: + +- pull request template +- issue templates for bug and feature/documentation requests + +## Local Overlay Policy + +Each organ may keep an overlay standards file in its `.github` repository: + +- path: `README_STANDARDS.md` +- purpose: local additions and stricter checks +- requirement: must link back to this canonical policy +- rule: overlay cannot weaken canonical requirements + +## Enforcement + +Each organ superproject should provide a local audit script: + +- recommended path: `tools/audit_platform_standards.sh` + +Each audit should check, at minimum: + +1. required standards files exist +2. README has minimum section structure for its tier/profile +3. local overlay links to this canonical policy + +Any exception must be tracked via issue with owner + due date. diff --git a/profile/README.md b/profile/README.md index 88cbbcf..7e78bbe 100644 --- a/profile/README.md +++ b/profile/README.md @@ -16,7 +16,7 @@ _System-wide registry, governance rules, and cross-organ coordination_ [![Organ VI — Koinonia](https://img.shields.io/badge/VI-Koinonia-20B2AA)](https://github.com/organvm-vi-koinonia) [![Organ VII — Kerygma](https://img.shields.io/badge/VII-Kerygma-FF1493)](https://github.com/organvm-vii-kerygma) -**81 repositories • ~320,000 words of documentation • 8 GitHub organizations • 16 published essays** +**113 repositories • 404K+ words of documentation • 8 GitHub organizations • 16 published essays** **[Read the essays →](https://organvm-v-logos.github.io/public-process/)** @@ -89,8 +89,8 @@ No back-edges exist in the dependency graph. Commerce cannot reach back into Art | Metric | Value | |--------|------:| -| Total repositories | 81 | -| Total documentation | ~320,000 words | +| Total repositories | 113 | +| Total documentation | 404K+ words | | Organ organizations live | 8 of 8 | | Profile READMEs deployed | 8 of 8 | | Published essays | 16 | @@ -128,13 +128,13 @@ If you are exploring this system for the first time, start here: This system exists at the intersection of several disciplines that rarely meet: -- **Systems architecture** — Eight organizations, 81 repositories, explicit dependency graphs, promotion state machines, and governance automation. The infrastructure demonstrates fluency with distributed systems thinking applied to creative production. +- **Systems architecture** — Eight organizations, 113 repositories, explicit dependency graphs, promotion state machines, and governance automation. The infrastructure demonstrates fluency with distributed systems thinking applied to creative production. - **Creative practice** — Generative art, interactive theatre, recursive epistemology, and metasystemic design. The work is not decorative; it is structurally integrated with the theoretical and commercial layers. - **Technical execution** — Data pipelines, browser extensions, SaaS platforms, agentic orchestration, and CI/CD automation. The commercial organ alone contains 22 repositories spanning multiple technology stacks. -- **Documentation as craft** — Over 320,000 words of portfolio-grade documentation and 16 published essays, written to be read by humans, not just parsed by machines. Every README is a demonstration of communicative precision. +- **Documentation as craft** — Over 404K+ words of portfolio-grade documentation and 16 published essays, written to be read by humans, not just parsed by machines. Every README is a demonstration of communicative precision. The organvm system is a proof of concept for a specific thesis: that creative work, theoretical inquiry, and commercial execution can be coordinated within a single coherent architecture — and that the architecture itself can be made legible, navigable, and beautiful. @@ -153,3 +153,15 @@ Built by [@4444j99](https://github.com/4444J99). *CONSOLIDATION-II Sprint 2026-02-12* + + +--- + +
+ +**Explore the System** + +[Portfolio](https://4444j99.github.io/portfolio/) · [System Directory](https://4444j99.github.io/portfolio/directory/) · [49 Essays](https://organvm-v-logos.github.io/public-process/) · [Knowledge Base](https://organvm-i-theoria.github.io/my-knowledge-base/) · [Consult](https://4444j99.github.io/portfolio/consult/) + +
+