{
  "markdown": "---\ntype: Repository Guide\ntitle: Terra Nexus Website Repository\ndescription: Monorepo containing the OKF knowledge bundle and future website application.\ntags:\n- repository\n- okf\n- terra-nexus\n- website\nstatus: stable\ngenerated:\n  by: github-copilot/claude-sonnet-4-6\n  at: '2026-08-01T00:00:00Z'\nsources:\n- id: confirmed-architecture\n  resource: knowledge/references/decisions/confirmed-knowledge-architecture.md\n  title: Confirmed Terra Nexus Knowledge Architecture\n  author: human:terra-nexus-owner\n---\n\n# Terra Nexus Website Repository\n\nThis monorepo contains the Terra Nexus OKF knowledge bundle and will house the future website application.\n\n## Quick Start\n\n```bash\npython -m pip install -e \".[dev]\"\npython scripts/validate_okf.py knowledge\npython scripts/tnx_validate.py knowledge\npython scripts/okf_cli.py --bundle knowledge index\npython scripts/okf_cli.py --bundle knowledge find \"regenerative agriculture\"\npython -m pytest tests/ -v\npython scripts/generate_inventory.py knowledge --tree\n```\n\n## Repository Layout\n\n| Path | Contents |\n|---|---|\n| `knowledge/` | OKF v0.2 knowledge bundle (governed content source of truth) |\n| `scripts/` | Validators, CLI navigator, inventory generator, skill sync |\n| `schemas/` | Canonical allowed-value registries |\n| `tests/` | Validator tests |\n| `plans/` | Project execution plans |\n| `.github/skills/` | Canonical agent skill (terra-nexus-content) |\n| `apps/web/` | Static Astro foundation and read-only OKF compiler |\n\n## Content Governance\n\nAll new content defaults to `publication.audience: internal, publication.state: blocked`. Nothing becomes public without a named approver in `publication.approved_by`. See CONTRIBUTING.md for the full workflow.\n\n### What Must Never Be Published\n\n- Illustrative company examples presented as Terra Nexus clients\n- Invented case studies, credentials, or market claims\n- Carbon & Ecosystem Services offering descriptions without individual owner approval\n- Content with `publication.state` other than `approved`\n- Original `.docx` source documents\n\n## Validation\n\n```bash\npython scripts/validate_okf.py knowledge     # OKF structural conformance\npython scripts/tnx_validate.py knowledge     # Terra Nexus domain rules\n```\n\n## Website Foundation Commands\n\nThe workspace uses Astro 6.4.6 and the Node 24.18.0 LTS version recorded in `.nvmrc` (Astro 6 requires Node 22.12.0 or later). See [HOW_TO_ADD_CONTENT.md](HOW_TO_ADD_CONTENT.md) for plain-language guidance.\n\n```powershell\nnpm ci\nnpm run content:new -- --type case-study\nnpm run content:status\nnpm run content:affected -- services/strategy-and-innovation\nnpm run content:validate\nnpm run content:finalize\nnpm run web:dev\nnpm run web:build\nnpm run web:test\nnpm run check\n```\n\n`npm run check` is the complete non-mutating repository check: it runs the OKF and Terra Nexus validators, Python tests, inventory freshness, skill sync, compiler validation, website tests, production build, and type checking. After changing a knowledge record, use `npm run content:finalize` to regenerate `knowledge/bundle-inventory.json` and `knowledge/TREE.txt` before it runs that same complete check. See [HOW_TO_ADD_CONTENT.md](HOW_TO_ADD_CONTENT.md) for the standard owner workflow.\n\nThe compiler is read-only for `knowledge/` and `schemas/`. It writes reproducible graph and safe-audit artifacts only to `apps/web/.generated/`, which Git ignores. Sensitive audit records use opaque diagnostic references rather than original confidential or proposal-only IDs. Phase 2B creates no governed-content routes, production deployment, Vercel project, CMS, analytics, or real case study.\n\n## For AI Agents\n\nStart at `knowledge/codex/start-here.md`. Use the `terra-nexus-content` skill. See `AGENTS.md`.\n\n## Important\n\n- Stable source-derived concepts must not contain `[agent-draft]` body sections.\n- Draft concepts are planning recommendations requiring owner review before publication.\n- Illustrative company examples in audience files are not client claims.\n- Known content gaps: `knowledge/website/open-issues-and-required-inputs.md`\n- See `HOW_TO_ADD_CONTENT.md` before adding proof or changing publication state.\n",
  "bytes": 4141,
  "sha": "10853e8e6acdba309a572067487c7e5fed84b04120b999e1523b8fac35570079",
  "repo_slug": "joshrtp/terra-nexus-web",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_joshrtp_terra_nexus_web_knowledge_index__b0f2ac5d/readme"
}