api/session_bootstrap.json

{
  "version": "system_context_v0",
  "generated_at": "2026-04-21T19:10:34Z",
  "one_liner": "system context is the single bootstrap payload an agent reads to know where it is, what governs it, and which payloads it may emit.",
  "entrypoint": {
    "api": "POST /turn",
    "cli": "bvtctl",
    "contract_ref": "api/conversational_api_v0.json",
    "why": "all agent interaction should start from one front door before widening into internal slices"
  },
  "current_position": {
    "slice_id": "conversational_api",
    "default_profile": "operator",
    "lineage_view": "operator_lineage",
    "role": "single front-door operator over the whole system"
  },
  "lineage": {
    "views": {
      "operator_lineage": [
        "conversational_api",
        "product_runtime",
        "graph_kernel",
        "control_benchmarks",
        "orchestrator_ux"
      ],
      "policy_lineage": [
        "conversational_api",
        "control_language",
        "product_runtime",
        "graph_kernel",
        "control_benchmarks"
      ],
      "full_stack": [
        "conversational_api",
        "orchestrator_ux",
        "control_language",
        "product_runtime",
        "graph_kernel",
        "control_benchmarks"
      ]
    },
    "slice_map": [
      {
        "id": "graph_kernel",
        "path": "vendor/meta3-graph-core",
        "purpose": "deterministic graph reifier and receipt-first kernel",
        "upstream_reference": "/Users/jobs/Desktop/tmp-meta3-engine-test/meta3-graph-core"
      },
      {
        "id": "control_language",
        "path": "policy",
        "purpose": "bits, vectors, tensors, gates, and confidence policy",
        "upstream_reference": "/Users/jobs/developer/nix-star"
      },
      {
        "id": "control_benchmarks",
        "path": "benchmarks",
        "purpose": "control scorecards, memory evals, tensor evals, and economics",
        "upstream_reference": "/Users/jobs/Desktop/Desktop(archive)/agents/NIX.codecli"
      },
      {
        "id": "conversational_api",
        "path": "api",
        "purpose": "one front-door API over graph state and control policy",
        "upstream_reference": "/Users/jobs/Desktop/Desktop(archive)/agents/NIX.codecli"
      },
      {
        "id": "orchestrator_ux",
        "path": "ux",
        "purpose": "one operator surface over the conversational API",
        "upstream_reference": "/Users/jobs/Desktop/Desktop(archive)/agents/NIX.codecli"
      },
      {
        "id": "product_runtime",
        "path": "runtime",
        "purpose": "thin manifest runtime, routing, and receipt flow",
        "upstream_reference": "/Users/jobs/developer/causal-workbench"
      }
    ]
  },
  "taxonomy": {
    "entry": [
      "conversational_api"
    ],
    "control": [
      "control_language",
      "product_runtime"
    ],
    "proof": [
      "graph_kernel",
      "control_benchmarks"
    ],
    "operator": [
      "orchestrator_ux"
    ],
    "import_intelligence": [
      "graph_kernel",
      "control_benchmarks"
    ]
  },
  "policy": {
    "vsm": {
      "version": "v0",
      "one_liner": "VSM governance says every agent enters through one API, reads policy and lineage, then acts through bounded payloads.",
      "identity": {
        "system_name": "bit_vector_tensor_control_policy",
        "entry_slice": "conversational_api",
        "default_profile": "operator",
        "operator_promise": "one front door, one control loop, one proof trail"
      },
      "systems": [
        {
          "id": "system_1",
          "name": "operate",
          "role": "deliver bounded user-visible work",
          "owned_slices": [
            "conversational_api",
            "product_runtime",
            "orchestrator_ux"
          ]
        },
        {
          "id": "system_2",
          "name": "coordinate",
          "role": "keep routing, handoffs, and visible interaction coherent",
          "owned_slices": [
            "conversational_api",
            "orchestrator_ux"
          ]
        },
        {
          "id": "system_3",
          "name": "control",
          "role": "govern lanes, gates, manifests, and execution posture",
          "owned_slices": [
            "control_language",
            "product_runtime"
          ]
        },
        {
          "id": "system_3_star",
          "name": "audit",
          "role": "verify what happened from receipts and scorecards",
          "owned_slices": [
            "graph_kernel",
            "control_benchmarks"
          ]
        },
        {
          "id": "system_4",
          "name": "intelligence",
          "role": "watch the wider field, update intake, and reshape the next import frontier",
          "owned_slices": [
            "graph_kernel",
            "control_benchmarks"
          ],
          "owned_paths": [
            "configs/source_registry.json",
            "hotgraph/source_hotgraph.json",
            "hotgraph/source_hotgraph.md"
          ]
        },
        {
          "id": "system_5",
          "name": "policy",
          "role": "hold identity, boundary, and non-negotiable invariants",
          "owned_slices": [
            "control_language"
          ]
        }
      ],
      "taxonomy": {
        "entry": [
          "conversational_api"
        ],
        "control": [
          "control_language",
          "product_runtime"
        ],
        "proof": [
          "graph_kernel",
          "control_benchmarks"
        ],
        "operator": [
          "orchestrator_ux"
        ],
        "import_intelligence": [
          "graph_kernel",
          "control_benchmarks"
        ]
      },
      "lineage_views": {
        "operator_lineage": [
          "conversational_api",
          "product_runtime",
          "graph_kernel",
          "control_benchmarks",
          "orchestrator_ux"
        ],
        "policy_lineage": [
          "conversational_api",
          "control_language",
          "product_runtime",
          "graph_kernel",
          "control_benchmarks"
        ],
        "full_stack": [
          "conversational_api",
          "orchestrator_ux",
          "control_language",
          "product_runtime",
          "graph_kernel",
          "control_benchmarks"
        ]
      },
      "agent_rules": [
        "enter through the conversational API before opening lower-level surfaces",
        "read policy and lineage before proposing execution",
        "use manifests for bounded action and receipts for proof",
        "treat graph state and receipts as higher authority than prose summaries",
        "show the user one coherent system view, not subsystem fragments"
      ]
    },
    "control_language": {
      "product_read": "standalone_agent_harness",
      "meta_modes": [
        {
          "id": "metacognitive",
          "one_liner": "inspect current state, uncertainty, and posture before acting",
          "why": "the system should know what it knows and where it is weak"
        },
        {
          "id": "metacybernetic",
          "one_liner": "regulate routes, gates, escalation, and proof loops",
          "why": "the system should steer itself, not just narrate"
        },
        {
          "id": "meta_learning",
          "one_liner": "update policy from receipts and benchmark results",
          "why": "the system should improve from proof, not vibes"
        }
      ],
      "bits": [
        {
          "id": "execution_allowed",
          "meaning": "whether the runtime may open the execution lane"
        },
        {
          "id": "receipt_required",
          "meaning": "whether promotion requires a durable receipt"
        },
        {
          "id": "freshness_conflict",
          "meaning": "whether new evidence conflicts with older memory"
        },
        {
          "id": "unsupported_query",
          "meaning": "whether the question should trigger abstention"
        }
      ],
      "vectors": [
        {
          "id": "control_vector",
          "axes": [
            "plan",
            "execute",
            "review",
            "promote"
          ],
          "meaning": "current operating posture across the main harness stages"
        },
        {
          "id": "lane_vector",
          "axes": [
            "memory",
            "tooling",
            "execution",
            "audit"
          ],
          "meaning": "which lane should dominate the next move"
        }
      ],
      "tensors": [
        {
          "id": "control_tensor_v0",
          "axes": {
            "source": [
              "dialogue",
              "receipts",
              "external_tools",
              "task",
              "graph_state"
            ],
            "stage": [
              "discover",
              "select",
              "execute",
              "review",
              "promote"
            ],
            "metric": [
              "fit",
              "evidence",
              "cost",
              "latency",
              "confidence",
              "promotion_readiness"
            ]
          },
          "meaning": "multi-surface operating posture over time and stage"
        }
      ],
      "invariants": [
        "confidence starts at zero until earned",
        "receipts gate promotion",
        "graph state outranks prose summaries",
        "unsupported queries should abstain plainly",
        "newer authoritative state should beat stale memory"
      ]
    },
    "runtime_profiles": [
      {
        "id": "bootstrap",
        "description": "use bootstrap hotgraph and packets to decide what should be imported next",
        "preferred_lane": "memory",
        "execution_allowed": false,
        "receipt_required": true
      },
      {
        "id": "operator",
        "description": "default active harness mode for user-facing work",
        "preferred_lane": "tooling",
        "execution_allowed": true,
        "receipt_required": true
      },
      {
        "id": "benchmark",
        "description": "evaluation-first mode for scorecards and regression checks",
        "preferred_lane": "audit",
        "execution_allowed": false,
        "receipt_required": true
      }
    ]
  },
  "runtime_contract": {
    "one_liner": "the runtime is a routed decision system, not a theory machine",
    "contract": "user intent -> capability route -> work manifest -> guarded execution -> receipt + graph -> decision brief",
    "acceptance_bar": [
      "recommendation is clear",
      "route is grounded",
      "proof is honest",
      "artifact is usable"
    ]
  },
  "payload_templates": {
    "turn_request": {
      "endpoint": "POST /turn",
      "auto_hydrated_fields": [
        "system_context",
        "policy_context",
        "lineage_context"
      ],
      "user_supplied_fields": [
        "user_input"
      ],
      "optional_state_fields": [
        "user_input",
        "thread_state",
        "receipt_state",
        "task_state",
        "tool_state",
        "alpha_state"
      ],
      "template": {
        "user_input": "<user_input>",
        "thread_state": null,
        "receipt_state": null,
        "task_state": null,
        "tool_state": null,
        "alpha_state": null
      }
    },
    "turn_response_fields": [
      "lane",
      "control_vector",
      "tensor_surface",
      "execution_gate",
      "receipt_requirements",
      "ui_projection",
      "decision_brief",
      "inference",
      "system_context"
    ],
    "work_manifest": {
      "schema_title": "Work Manifest Packet v0",
      "required_fields": [
        "version",
        "manifest_id",
        "goal",
        "lane",
        "execution_gate",
        "receipt_required",
        "actions"
      ],
      "template": {
        "version": "work_manifest_v0",
        "manifest_id": "<manifest_id>",
        "goal": "<goal>",
        "lane": "<lane>",
        "execution_gate": false,
        "receipt_required": true,
        "actions": [
          {
            "type": "write_file",
            "path": "<path>",
            "content": "<content>"
          }
        ]
      }
    }
  },
  "latest_runtime_state": {
    "graph_state_path": "/Users/jobs/Desktop/bit-vector-tensor-control-policy/runs/runtime/20260421T190042Z-demo_utir_write/graph_state.json",
    "receipt_path": "/Users/jobs/Desktop/bit-vector-tensor-control-policy/runs/runtime/20260421T190042Z-demo_utir_write/receipt.json",
    "summary_path": "/Users/jobs/Desktop/bit-vector-tensor-control-policy/runs/runtime/20260421T190042Z-demo_utir_write/summary.json",
    "latest_manifest_id": "demo_utir_write",
    "latest_lane": "execution",
    "latest_effect_count": 1
  },
  "agent_bootstrap": {
    "trust_order": [
      "graph_state",
      "receipts",
      "policy",
      "runtime_contract",
      "docs"
    ],
    "first_move": "read this packet, stay inside POST /turn, and escalate to manifests only when policy opens the gate",
    "promise": "one front door, one control loop, one proof trail"
  }
}