Skip to content

INDEX.md

Latest commit

 

History

History
56 lines (45 loc) · 2.51 KB

INDEX.md

File metadata and controls

56 lines (45 loc) · 2.51 KB
Raw

Repository Index

Navigation map for the Codegeist OS workspace. This file lists where information and implementation live; it does not duplicate project documentation.

Project Documentation

  • README.md - public repository frontpage, current state, primary workflows, documentation links, hosting, and license context.
  • docs/architecture.md - system architecture and component boundaries.
  • docs/base-system-selection.md - base-system and Nix interface decisions.
  • docs/artifact-contract.md - artifact ownership, pins, provenance, licenses, and verification contracts.
  • docs/build-workflow.md - build, test, installer, and release workflows.
  • docs/feature-demos.md - feature recording, GIF curation, validation, and publication workflow.
  • docs/speech-model-evaluation.md - speech candidates, measurements, and evaluation requirements.
  • docs/security.md - identity, access, isolation, approval, audit, and recovery requirements.

Build And Runtime Sources

  • Taskfile.yml - contributor command entrypoints.
  • default.nix - classic Nix package, image, runner, and test attributes.
  • nix/artifacts.nix - immutable external artifact metadata.
  • nix/packages/ - package definitions.
  • nix/modules/ - shared NixOS modules.
  • nix/profiles/ - VM and installer profiles and installer-owned assets.
  • nix/tests/ - automated NixOS tests and fixtures.
  • scripts/installer-test-probe.sh - installer-test inspection helper.
  • scripts/run-installer-smoke.sh - visible production installer smoke runner.
  • scripts/record-installer-demo.sh - installer feature-demo recorder.

Workspace Configuration

  • opencode.json - project OpenCode configuration.
  • .devcontainer/ - shared development-environment submodule.
  • .opencode/ - shared OpenCode agent-kit submodule.
  • .oc_local/ - project-specific OpenCode overlays.
  • .oc_local/rules/index-boundary.md - repository index content boundary.
  • .oc_local/rules/nix-input-minimality.md - direct Nixpkgs pinning boundary.
  • .oc_local/rules/readme-boundary.md - repository README content boundary.
  • .codegeist/ - project-local development-container extension.
  • .gitmodules - submodule sources and tracking configuration.
  • .gitignore - generated and machine-local file exclusions.
  • LICENSE - repository-owned material license.

Source References

  • refs/codegeist/ - Codegeist CLI source-reference submodule.
  • refs/codegeist-llm/ - Codegeist LLM source-reference submodule.

Directory Indexes

  • INDEX.md - repository-root navigation map.