coulomb/kings-guard
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Adaptive immune security architecture for netkingdom
10 commits 1 branch 0 tags 475 KiB
Find a file
codex 061b4b35f9 docs(agents): repoint remote State Hub URL to the in-cluster address 
The remote row pointed at 127.0.0.1:18000, a reverse tunnel back to the
workstation. On railiance01 the State Hub runs in the cluster on that same
machine, so the request left the box and came back to reach a local service.

Refs CUST-WP-0067-T07

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 2583210@bnt-lap001
Assistant-Session: f2bff2d5-e9b2-4338-92ca-10282a927006
2026-08-25 00:21:17 +02:00
docs Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
history Register kings-guard with State Hub 2026-07-23 22:55:42 +02:00
intake Close absorbed qonto pilot intake 2026-07-24 00:34:52 +02:00
specs Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
src/kings_guard Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
tests Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
workplans Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-07-24 00:16:02 +02:00
.gitignore Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
.repo-classification.yaml Register kings-guard with State Hub 2026-07-23 22:55:42 +02:00
AGENTS.md docs(agents): repoint remote State Hub URL to the in-cluster address 2026-08-25 00:21:17 +02:00
INTENT.md Register kings-guard with State Hub 2026-07-23 22:55:42 +02:00
LICENSE Adopt Target Revenue Source License V1C1 (org-wide preliminary rollout) 2026-07-30 00:28:01 +02:00
Makefile Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
pyproject.toml Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
README.md Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
SCOPE.md Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00
WORK-RECORDS.md Implement KG-WP-0002 posture pilot scaffold 2026-07-24 00:24:53 +02:00

README.md

kings-guard

Adaptive security contracts and posture-evaluation scaffold for NetKingdom's immune-architecture work.

Current slice

This repository now contains four aligned pieces:

  • INTENT.md / SCOPE.md for the repo's stable boundary
  • specs/NetKingdomImmuneArchitecture.md for the reference architecture
  • specs/ImmuneContracts.md for the first canonical contract layer
  • src/kings_guard/ plus tests/ for a minimal posture loop scaffold

The current implementation is intentionally narrow. It does not provide a running security control plane yet. It provides:

  • typed contracts for security genome, phenotype, observation, posture, signal, effector request, and immune memory entry;
  • a minimal posture evaluator that turns a normalized observation into a posture assessment and bounded response hints;
  • a fixture-driven pilot based on qonto-assistant, chosen because it already exposes a security genome record, an audit stream, and a fast local loop.

Repo layout

  • specs/NetKingdomImmuneArchitecture.md
  • specs/ImmuneContracts.md
  • docs/AdjacentSystemBoundary.md
  • docs/pilots/QontoAssistantPosturePilot.md
  • src/kings_guard/
  • tests/
  • workplans/

Dev commands

# preferred, if make + pip are available
make install-dev
make test
make lint
make run-demo

# direct shell fallback used in minimal environments
python3 -m pytest -q
PYTHONPATH=src python3 -m kings_guard.main --pilot qonto-assistant