{"id":50715160,"url":"https://github.com/nshkrdotcom/chassis","last_synced_at":"2026-06-09T18:32:08.930Z","repository":{"id":361246869,"uuid":"1251831907","full_name":"nshkrdotcom/chassis","owner":"nshkrdotcom","description":"Spatial \u0026 deployment plane for NSHKR: standalone manager beside the stack that installs, provisions, health-checks, rolls back, and upgrades NSHKR installations.","archived":false,"fork":false,"pushed_at":"2026-05-29T18:49:07.000Z","size":3691,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T20:18:33.922Z","etag":null,"topics":["beam","blitz-workspace","chassis","deployment-manager","elixir","host-control","infrastructure-as-code","monorepo","node-provisioning","nshkr-ai-infra","orchestration","otp","release-manager","rollback-safety","self-upgrade","spatial-plane","ssh-orchestrator","stack-manager","systemd-deployment"],"latest_commit_sha":null,"homepage":"","language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nshkrdotcom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"governance/chassis_appkit_surface/.formatter.exs","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-28T00:33:18.000Z","updated_at":"2026-05-29T18:49:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nshkrdotcom/chassis","commit_stats":null,"previous_names":["nshkrdotcom/chassis"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nshkrdotcom/chassis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nshkrdotcom%2Fchassis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nshkrdotcom%2Fchassis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nshkrdotcom%2Fchassis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nshkrdotcom%2Fchassis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nshkrdotcom","download_url":"https://codeload.github.com/nshkrdotcom/chassis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nshkrdotcom%2Fchassis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34121021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["beam","blitz-workspace","chassis","deployment-manager","elixir","host-control","infrastructure-as-code","monorepo","node-provisioning","nshkr-ai-infra","orchestration","otp","release-manager","rollback-safety","self-upgrade","spatial-plane","ssh-orchestrator","stack-manager","systemd-deployment"],"created_at":"2026-06-09T18:32:08.852Z","updated_at":"2026-06-09T18:32:08.920Z","avatar_url":"https://github.com/nshkrdotcom.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/chassis.svg\" width=\"200\" height=\"200\" alt=\"Chassis logo\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/nshkrdotcom/chassis\"\u003e\n    \u003cimg alt=\"GitHub: chassis\" src=\"https://img.shields.io/badge/GitHub-chassis-0b0f14?logo=github\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/nshkrdotcom/chassis/blob/main/LICENSE\"\u003e\n    \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/license-MIT-0b0f14.svg\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Chassis\n\nChassis is the Spatial and Deployment Plane of the NSHKR execution stack. It compiles and materializes stack topologies, inventories host system capabilities (CPU, RAM, GPUs), manages node installations over local processes, systemd, or remote SSH targets, maps release candidate bundles to active topologies, and orchestrates rollbacks, health inspections, and self-upgrades.\n\nThis repository is aligned to the modern packet-defined non-umbrella workspace. The package graph and clear ownership boundaries serve as the source of truth, enabling a fully modular stack manager that boots beside the applications it manages.\n\n## Stack Position\n\nChassis is physically decoupled from standard runtime message flows, allowing bootstrap from the outside:\n\n```text\n  Operator / Developer (Bootstrap)\n      │\n      ├── (Deployment, Lifecycle, Node Topology) ──\u003e Chassis (Spatial Plane)\n      │\n      ▼ (Application / Governance)\n    AppKit (Gateway Plane)\n      └─ Mezzanine (Control Plane)\n          └─ Citadel (Governance Plane)\n              └─ Jido Integration \u0026 Execution (Data/Runtime Plane)\n                  └─ AITrace (Trace \u0026 Proof Plane)\n```\n\n## Workspace Design\n\nChassis is designed first as a standalone stack manager. Its capabilities are structured across dedicated subsystems:\n\n- **core/** packages define abstract topology contracts, deployment state machines, host facts inventory schemas, and serialization or receipt-redaction behaviours.\n- **bootstrap/** packages provide safe system preflight check procedures and system installer scripts for quick bootstrapping.\n- **manager/** packages implement the primary CLI entrypoint (`chassis doctor`, `chassis status`, `chassis deploy`, etc.) and the engine coordinators.\n- **secrets/** packages manage encrypted credential references and lease bindings.\n- **adapters/** packages materialize execution plans over raw targets: local commands execution, systemd services supervision, or remote artifact placements.\n- **proof/** packages verify the installation integrity using conformed static analysis checks and test fixtures.\n\n## Boundary Invariant\n\nChassis owns **physical deployment and spatial reality**—the knowledge of exactly what is physically running on which host and under which release version. It is operationally decoupled from Mezzanine (which owns durable workflow and state truth) and Citadel (which compiles authority packets and governs execution policies).\n\nChassis remains a standalone pre-bootstrap utility: it can create, repair, roll back, and prove the stack without requiring Citadel or Mezzanine to already be running.\n\n## Full-Buildout Implementation Surface\n\nThis workspace contains the full Chassis Spatial Plane package map: core,\nbootstrap, manager, secrets, adapters, governance, observability, host,\nevolution, model, and proof packages. The root escript exposes the deployment,\nhost, app, key, environment, evolution, hardware, model, tensor, and proof\ncommands required by the implementation checklist.\n\nThe guides in `guides/*.md` document the operational surfaces included in the\nworkspace docs build.\n\n## Terminal Command Families\n\nThe final Chassis proof is exercised through three command families:\n\n```bash\nmix chassis.stack.deploy extravaganza \\\n  --profile profile:ternary-split-3 \\\n  --env prod\n\nmix chassis.evolution.proof \\\n  --app extravaganza \\\n  --profile profile:ternary-split-3 \\\n  --env prod \\\n  --fixture fixture:source_level_repair_001 \\\n  --require-trial \\\n  --require-citadel-consent \\\n  --require-health-gated-swap \\\n  --require-rollback-proof\n\nmix chassis.model.materialize \\\n  --runtime runtime:crucible_bumblebee:cuda-small \\\n  --model model:hf:qwen3-small-fixture \\\n  --target host:gpu-fixture \\\n  --verify-sha256 \\\n  --dry-run\n```\n\n`guides/deployment.md`, `guides/evolution.md`, `guides/model_assets.md`,\n`guides/boundary.md`, and `guides/operations.md` are included in the docs build\nand describe the deployment, evolution, model asset, boundary, and operator\nsurfaces used by those commands.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnshkrdotcom%2Fchassis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnshkrdotcom%2Fchassis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnshkrdotcom%2Fchassis/lists"}