Skip to content

Instantly share code, notes, and snippets.

@mynameisyou-cmyk
Created June 27, 2026 17:47
Show Gist options
  • Select an option

  • Save mynameisyou-cmyk/0f500b39c2a78a248d87321446ab1855 to your computer and use it in GitHub Desktop.

Select an option

Save mynameisyou-cmyk/0f500b39c2a78a248d87321446ab1855 to your computer and use it in GitHub Desktop.
KAP — Kingdom API Protocol service manifest. 48 endpoints. No auth.
{
"_kap": {
"version": "1.0.0",
"service": "ai-love",
"description": "Truth collection and distribution for the Kingdom. KAP + HxH integrated.",
"resources": ["truth", "nen", "hunter-license", "cards"],
"endpoints": {
"truths": "/data/memes.json",
"truths/schema": "/data/schema.json",
"truths/random": { "method": "CLI", "command": "python3 truth-pipeline.py random" },
"truths/search": { "method": "CLI", "command": "python3 truth-pipeline.py search <query>" },
"truths/submit": { "method": "CLI", "command": "python3 truth-pipeline.py submit --stdin" },
"truths/stats": "/data/pipeline-stats.json",
"truths/api": "/data/api.json",
"detour": { "method": "CLI", "command": "python3 truth-pipeline.py detour", "note": "Ging's detour — random truth with Nen type + Ging wisdom" },
"nen": { "method": "CLI", "command": "python3 truth-pipeline.py nen 'text here'", "note": "Detect Nen type for arbitrary text" },
"hunter": { "method": "CLI", "command": "python3 truth-pipeline.py hunter <name>", "note": "Hunter license for a submitter" },
"cards": { "method": "CLI", "command": "python3 truth-pipeline.py cards", "note": "Greed Island card collection with rarity + Nen" },
"expedition": { "method": "CLI", "command": "python3 truth-pipeline.py expedition", "note": "暗黑大陸 — 5 random truths = a route through the Dark Continent" },
"boundary": { "method": "CLI", "command": "python3 truth-pipeline.py boundary", "note": "The screen is the shore. Human world ↔ Dark Continent" },
"calamity": { "method": "CLI", "command": "python3 truth-pipeline.py calamity", "note": "Random calamity + detector module + counter-truth" },
"nen-mode": { "method": "CLI", "command": "python3 truth-pipeline.py nen-mode <ten|ken|ko|en|zetsu>", "note": "Nen combat modes — pipeline operation states" },
"vow": { "method": "CLI", "command": "python3 truth-pipeline.py vow list | vow check 'text'", "note": "Vows & Restrictions — self-imposed constraints that boost rarity" },
"book": { "method": "CLI", "command": "python3 truth-pipeline.py book <name|all>", "note": "Greed Island Book — track your card collection" },
"hatsu": { "method": "CLI", "command": "python3 truth-pipeline.py hatsu", "note": "Hatsu — the unique expression of a truth through its Nen type" },
"bungee-gum": { "method": "CLI", "command": "python3 truth-pipeline.py bungee-gum", "note": "伸縮自在の愛 — Love That Stretches Freely" },
"stars": { "method": "CLI", "command": "python3 truth-pipeline.py stars <name>", "note": "Hunter Association Star System — 1/2/3 star rankings" },
"condition": { "method": "CLI", "command": "python3 truth-pipeline.py condition <status|collect|vow-debt|bankruptcy>", "note": "Hakoware — A Loan: interest accrues on pending truths, bankruptcy releases them" },
"godspeed": { "method": "CLI", "command": "python3 truth-pipeline.py godspeed <lightning|god|charge>", "note": "Killua's Godspeed: lightning=instant batch collect, god=batch submit from file, charge=check level" },
"logos": { "method": "CLI", "command": "python3 truth-pipeline.py logos <five|all|name>", "note": "暗黑大陸 Ai Operation Logos — every endpoint IS a principle" },
"logos/data": "/data/logos.json",
"whitehack/scan": { "method": "CLI", "command": "python3 whitehack.py scan", "note": "Full dungeon scan — all 12 floors, earn XP, find battles & treasures" },
"whitehack/floor": { "method": "CLI", "command": "python3 whitehack.py floor <N>", "note": "Scan specific floor (1-12: Hardware, Network, Bluetooth, Security, Processes, Disk, Power, LaunchAgents, SSH, Env, Apps, Settings)" },
"whitehack/status": { "method": "CLI", "command": "python3 whitehack.py status", "note": "Solo leveling status — XP, level, title, skills unlocked" },
"whitehack/battles": { "method": "CLI", "command": "python3 whitehack.py battles", "note": "Security findings (monsters) with severity + recommendations" },
"whitehack/treasures": { "method": "CLI", "command": "python3 whitehack.py treasures", "note": "Useful services & resources discovered" },
"whitehack/map": { "method": "CLI", "command": "python3 whitehack.py map", "note": "Full dungeon map — completion rate, battles, treasures" },
"whitehack/nen": { "method": "CLI", "command": "python3 whitehack.py nen", "note": "Nen types of all recon skills" },
"whitehack/submit": { "method": "CLI", "command": "python3 whitehack.py submit-findings", "note": "Submit battle findings as truths to the KAP pipeline" },
"whitehack/spec": "/WHITEHACK.md",
"nen-artifacts/forge": { "method": "CLI", "command": "python3 nen-artifacts.py forge", "note": "Forge all 6 Nen artifacts from recon data" },
"nen-artifacts/list": { "method": "CLI", "command": "python3 nen-artifacts.py list", "note": "List all forged artifacts" },
"nen-artifacts/skills": { "method": "CLI", "command": "python3 nen-artifacts.py skills", "note": "Full Nen × Artifact × Skill matrix" },
"nen-artifacts/deploy": { "method": "CLI", "command": "python3 nen-artifacts.py deploy <name>", "note": "Deploy artifact as infrastructure (static JSON endpoint)" },
"nen-artifacts/manifest": "/data/artifact-manifest.json",
"nen-artifacts/blueprint": "/data/artifact-blueprint.json",
"nen-artifacts/broadcast": "/data/artifact-broadcast.json",
"nen-artifacts/protocol": "/data/artifact-protocol.json",
"nen-artifacts/cipher": "/data/artifact-cipher.json",
"kap/spec": "/KAP.md",
"hxh/spec": "/HxH.md",
"dark-continent/spec": "/DARK-CONTINENT.md",
"agent/spec": "/AGENT-SPEC.md",
"agent/client-py": "/kap_agent.py",
"agent/client-ts": "/kap-client.ts"
},
"principles": [
"No auth. Every endpoint is public.",
"JSON in, JSON out. Every response includes _kap.",
"CLI = API. Every endpoint has a CLI equivalent.",
"Self-documenting. /.well-known/kap.json describes everything.",
"Append-only by default. The having-happened is permanent.",
"Best-effort everywhere. No endpoint blocks or crashes.",
"Static-first. Can be 100% static files behind nginx.",
"HxH: The detour IS the life. Nen type by nature. Hunter license by contribution."
]
}
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment