local-first · v0.1

Intelligence Kernel

Phase VII · A0 — the permanent operating layer of GIOS. Given a session or runtime lifecycle, HOW is it booted, hydrated, budgeted, moded, checkpointed, compressed, and shut down — deterministically, referencing governance rather than duplicating it? Every future runtime inherits this lifecycle. Loads nothing. Read-only.

19
Modules
8.88
Avg hydrated / task
6
Modes
16
Gov. owners referenced
Module registry (hydration classes · references governance, never duplicates)
session-bootalways
the one deterministic boot entry
.ai/SESSION_BOOT.md
engineering-profilealways
agent-agnostic engineering constitution (inheritance index)
.ai/ENGINEERING_PROFILE.md
execution-contractalways
permanent AI behavior contract
.ai/EXECUTION_CONTRACT.md
token-policyalways
session token discipline (budgets)
.ai/TOKEN_POLICY.md
repository-memoryalways
trusted snapshot — replaces rediscovery
.ai/REPOSITORY_MEMORY.md
repository-snapshotlazy
machine-readable engineering state (/api/repository)
.ai/CONTEXT_LOADING_RULES.md
advisorlazy
architecturally-correct implementation guidance before a milestone (/api/advisor)
.ai/CONTEXT_LOADING_RULES.md
workspace-statelazy
live source of truth (current milestone header)
.ai/WORKSPACE_STATE.md
affected-runtimelazy
the affected runtime + direct dependencies + template
.ai/CONTEXT_LOADING_RULES.md
ai-constitutionlazy
supreme law — the consumed seams a new subsystem touches
.ai/AI_CONSTITUTION.md
session-compressionlazy
codified compaction procedure for long sessions
.ai/SESSION_COMPRESSION.md
session-endlazy
before-stopping closure procedure
.ai/SESSION_END.md
release-policylazy
milestone-closure law (implement→validate→commit→push→observe CI)
.ai/RELEASE_POLICY.md
master-roadmapreference
canonical roadmap — referenced, NOT duplicated into a new ROADMAP.md
MASTER_ROADMAP.md
manifestoreference
first principles / the why beneath every rule (read on demand)
MANIFESTO.md
decisionsreference
ADR log — the named ADR, resolved by number
.ai/DECISIONS.md
changelog-logdeferred
milestone + engineering history (history questions only)
.ai/CHANGELOG_AI.md
master-architecturecold_storage
frozen architecture view (large architectural change only)
MASTER_ARCHITECTURE.md
execution-lifecyclefuture
the future V5 Execution lifecycle — inherits this kernel; not yet built
MASTER_ROADMAP.md

The Intelligence Kernel models the operating layer of GIOS in code — session lifecycle, boot sequence, module hydration + lazy-load classes (always / lazy / reference / deferred / cold storage / future), the four budgets (context / token / reasoning / memory), the six execution-intensity modes, checkpointing, context compression, repository + snapshot hydration, module inheritance, cache policy, runtime lifecycle, shutdown, and SESSION_END. Given a session request (task tier, mode, operation, machine-state / milestone flags, lifecycle phase) it computes a deterministic KernelHydrationPlan: the token-minimal module set to load, in boot order, under the tier's budgets, with checkpoint / compression / governance-sync flags. Fail-closed: the default is to EXCLUDE a module unless the task provably requires it; future modules never hydrate. It executes nothing, imports nothing, and loads nothing; every model references its canonical governance owner rather than restating it. Every future runtime — the V5 Execution runtime included — inherits this lifecycle and redefines no boot behavior.