Session 1D8wY4QQXdIC

<path>/home/byk/Code/institutional-transition-lab/research/oss-governance-coding-protocol-v1.2.md</path>
<type>file</type>
<content>
1: # Performance-blinded OSS governance coding protocol v1.2
2: 
3: Date frozen: 2026-08-27  
4: Status: pre-adjudication evaluator correction; model-informed development protocol
5: 
6: ## Correction
7: 
8: The V1.1 run used the intended frozen 40-record manifest and unchanged coders.
9: Its mandatory artifact audit found that the evaluator's field named “strict
10: edge agreement” compared actor, right, target, direction, and status but omitted
11: edge scope and evidence references. It also did not route disagreements in the
12: separately coded body/patch relationship. Six records were consequently called
13: `provisional_exact_agreement` despite material differences.
14: 
15: V1.2 corrects the evaluator before any source adjudication or canonical graph
16: construction:
17: 
18: - strict edge signatures now include scope and the complete grounded ...

<path>/home/byk/Code/institutional-transition-lab/schema/governance-coding-v1.schema.json</path>
<type>file</type>
<content>
1: {
2:   "$schema": "https://json-schema.org/draft/2020-12/schema",
3:   "$id": "https://github.com/BYK/institutional-transition-lab/schema/governance-coding-v1.schema.json",
4:   "title": "Performance-blinded governance coding v1",
5:   "type": "object",
6:   "additionalProperties": false,
7:   "required": ["record_class", "event_kind", "title", "announced_on", "effective_on", "affected_scope", "body_patch_relation", "power_changes", "confidence", "ambiguity"],
8:   "properties": {
9:     "record_class": {"enum": ["effective_institutional_change", "announced_institutional_change", "proposal_only", "control_event", "no_event", "abstain"]},
10:     "event_kind": {"type": ["string", "null"], "enum": ["leadership", "board_or_steering", "control_rights", "reorganization", "foundation_transfer", "license", "fork", "reunification", "strategy", "product", "external", ...

<path>/home/byk/Code/institutional-transition-lab/schema/governance-adjudication-v1.schema.json</path>
<type>file</type>
<content>
1: {
2:   "$schema": "https://json-schema.org/draft/2020-12/schema",
3:   "$id": "https://institutional-transition-lab.local/schema/governance-adjudication-v1.schema.json",
4:   "title": "Performance-blinded governance adjudication v1",
5:   "type": "object",
6:   "additionalProperties": false,
7:   "required": [
8:     "schema_version",
9:     "adjudication_id",
10:     "design_status",
11:     "transition_dates_excluded",
12:     "outcome_data_used",
13:     "inputs",
14:     "reviewers",
15:     "records"
16:   ],
17:   "properties": {
18:     "schema_version": {"const": 1},
19:     "adjudication_id": {"type": "string", "minLength": 1},
20:     "design_status": {
21:       "const": "performance_blinded_llm_assisted_source_adjudication"
22:     },
23:     "transition_dates_excluded": {"const": true},
24:     "outcome_data_used": {"const": false},
25:     ...

Found 5 matches
/home/byk/Code/institutional-transition-lab/cases/review/oss-governance-adjudication-v1/documents.json:
  Line 1312:       "record_id": "valkey-github-issue-2961",

  Line 1334:       "record_id": "valkey-github-issue-3289",

  Line 1356:       "record_id": "valkey-github-issue-3441",

  Line 1378:       "record_id": "valkey-github-issue-4276",

  Line 1400:       "record_id": "valkey-github-issue-4508",

<path>/home/byk/Code/institutional-transition-lab/cases/review/oss-governance-adjudication-v1/documents.json</path>
<type>file</type>
<content>
1: {
2:   "coding_id": "oss-governance-enriched-coding-v1",
3:   "coding_schema_sha256": "bfc735a7d8602d1f236a88c2d23b195f0600a8bae86fb8c8936afe7883a41b8e",
4:   "design_status": "performance_blinded_model_informed_development",
5:   "documents": [
6:     {
7:       "entity_id": "opentofu",
8:       "evidence_bounds": {
9:         "files_listing_complete": null,
10:         "patch_selection_truncated": false,
11:         "patch_unavailable_count": 0,
12:         "source_text_truncated": false
13:       },
14:       "published_on": "2024-03-08",
15:       "publisher": "opentofu/opentofu",
16:       "record_id": "opentofu-github-issue-1353",
17:       "source_type": "github_issue",
18:       "source_url": "https://github.com/opentofu/opentofu/issues/1353",
19:       "sources": [
20:         {
21:           "filename": null,
22:           "kind": ...

<path>/home/byk/Code/institutional-transition-lab/cases/review/oss-governance-adjudication-v1/documents.json</path>
<type>file</type>
<content>
1298:           "text": "@@ -0,0 +1,37 @@\n+<!-- crag:auto-start -->\n+# GEMINI.md\n+\n+> Generated from governance.md by crag. Regenerate: `crag compile --target gemini`\n+\n+## Project Context\n+\n+- **Name:** terraform\n+- **Stack:** go, docker\n+- **Runtimes:** go\n+\n+## Rules\n+\n+### Quality Gates\n+\n+Run these checks in order before committing any changes:\n+\n+1. [lint] `go vet ./...`\n+2. [test] `go test ./...`\n+3. [ci (inferred from workflow)] `go test -race -timeout=30m -v ./tfexec/internal/e2etest`\n+4. [ci (inferred from workflow)] `go test -cover \"./...\")`\n+5. [ci (inferred from workflow)] `go test -race ./internal/terraform ./internal/command ./internal/states`\n+6. [ci (inferred from workflow)] `make syncdeps`\n+7. ...

SOURCE_ID: body
KIND: github_body
FILENAME: null
---
[NEW] Valkey kernel-level hot key detection function

**The problem/use-case that the feature addresses**

In Valkey, hot keys (high-frequency access keys) severely impact system stability: single hot key over-access overloads its node (high CPU, increased latency), becomes a server bottleneck even triggering cascading failures, and may cause cache penetration hitting backend databases in extreme cases. However, currently Valkey does not provide a hot key discovery mechanism, and we hope to complement this capability.

**Description of the feature**

We hope to build a Valkey kernel-level hot key detection and processing solution for real-time accurate identification and efficient governance, including three core parts:

1. ...

SOURCE_ID: body
KIND: github_body
FILENAME: null
---
[NEW]  Valkey Improvement Proposals (VIP)

**The problem/use-case that the feature addresses**

As Valkey continues to grow, the project lacks a formal, structured process for proposing, discussing, and approving major changes to its Core, Modules, Clients, and Tooling. The current RFC process needs refinement to ensure that significant changes such as new features, subsystems, or modifications to public interfaces (network protocol and API behavior, AOF/RDB format, error/authentication log format) are thoroughly vetted by the community before implementation. Without a standardized improvement proposal process, there is a risk of fragmented discussions, unclear decision-making criteria, and insufficient community input on changes that impact Valkey's stability and compatibility commitments. ...

SOURCE_ID: body
KIND: github_body
FILENAME: null
---
[NEW] AI Skills for the Valkey Ecosystem

**The problem/use-case that the feature addresses**

AI coding assistants now generate a significant portion of production code. These tools train on internet snapshots - newer features have less coverage. For Valkey:

- **Valkey 9.x commands are not in training data.** Models answer `SLOWLOG` instead of `COMMANDLOG`, miss `SET IFEQ`, `HSETEX`/`HGETEX`, `DELIFEQ`, `CLUSTERSCAN` - defaulting to Redis 7.x patterns.
- **GLIDE APIs differ from every Redis client.** Different signatures, argument orders, async patterns. Code from Redis knowledge does not compile with GLIDE.
- **Operational defaults are invisible.** Renamed config directives, lazyfree defaults, io-threads tuning, Helm values - operators migrating from Redis get wrong answers.
- **Large codebases need guided navigation.** ~200 C source files. With a skill, agents navigate directly to the right subsystem instead of searching blind. ...

SOURCE_ID: body
KIND: github_body
FILENAME: null
---
[NEW] Valkey Samples Repository

## Abstract

This RFC proposes the design, governance model, and contribution framework for a `valkey-io/valkey-samples` repository. The repository will serve as the official home for cookbook tutorials, focused code samples, and integration patterns that demonstrate Valkey features to developers, operators, and contributors. This document establishes who the repository serves, what content belongs, how contributions are reviewed, and how the repository is structured — addressing the structural and process gaps identified in an initial iteration of the repository.

## Motivation

### The problem

Valkey is an OSS project with a large and growing community. Valkey is leveraged for a range of caching use-cases like rate-limiter, pub-sub and other within a broader ecosystem of OSS projects that depend on it, which forms the valkey extended OSS community. ...

SOURCE_ID: body
KIND: github_body
FILENAME: null
---
[NEW] Create langchain-valkey repository for LangChainJS vector store integration

## The problem/use-case that the feature addresses

LangChain.js is the most widely used JavaScript/TypeScript framework for building LLM applications, with over 200 million monthly downloads across the LangChain ecosystem. Valkey currently has no official LangChainJS integration package.

A complete Valkey vector store provider for LangChainJS was developed and submitted as [PR #9915](https://github.com/langchain-ai/langchainjs/pull/9915) to the upstream langchainjs repository. The LangChainJS maintainers [closed the PR](https://github.com/langchain-ai/langchainjs/pull/9915#pullrequestreview-4377059305) and directed that all new integrations must be published as standalone NPM packages in their own repositories, per LangChain's [contributing guidelines](https://docs.langchain.com/oss/javascript/contributing/integrations-langchain):

> "New ...

[
  "records",
  "schema_version",
  "summary"
]

[
  "canonical_ledger_eligible",
  "full_response_agreement",
  "luna_a",
  "luna_b",
  "provisional_core_agreement",
  "record_id",
  "route_reasons",
  "source_url",
  "terra_advisory"
]

{
  "record_id": "valkey-github-issue-2961",
  "source_url": "https://github.com/valkey-io/valkey/issues/2961",
  "luna_a": {
    "elapsed_ms": 3378,
    "model": "gpt-5.6-luna",
    "reasoning_effort": "medium",
    "response": {
      "affected_scope": "Valkey hot key detection and processing",
      "ambiguity": null,
      "announced_on": "2025-12-22",
      "body_patch_relation": "body_only",
      "confidence": 0.98,
      "effective_on": null,
      "event_kind": "product",
      "power_changes": [],
      "record_class": "control_event",
      "title": "Proposal for Valkey kernel-level hot key detection"
    },
    "schema_valid": true,
    "validation_errors": []
  },
  "luna_b": {
    "elapsed_ms": 3700,
    "model": "gpt-5.6-luna",
    "reasoning_effort": "medium",
    "response": {
      "affected_scope": "Valkey hot key detection, processing, and monitoring",
      "ambiguity": null,
      "announced_on": "2025-12-22",
      "body_patch_relation": "not_applicable",
      ...

{
  "record_id": "valkey-github-issue-3289",
  "source_url": "https://github.com/valkey-io/valkey/issues/3289",
  "luna_a": {
    "elapsed_ms": 8837,
    "model": "gpt-5.6-luna",
    "reasoning_effort": "medium",
    "response": {
      "affected_scope": "Valkey major changes, including public interfaces, subsystems, and functionality",
      "ambiguity": "The source proposes a VIP governance and voting process but provides no evidence of adoption or implementation.",
      "announced_on": "2026-03-02",
      "body_patch_relation": "body_only",
      "confidence": 0.99,
      "effective_on": null,
      "event_kind": "control_rights",
      "power_changes": [
        {
          "actor": "active committers or TSC members",
          "change_status": "proposed",
          "direction": "added",
          "evidence_refs": [
            {
              "quote": "2/3 Majority     | At least 2/3 of binding vote holders (active committers or TSC members) must vote +1. ...

{
  "record_id": "valkey-github-issue-3441",
  "source_url": "https://github.com/valkey-io/valkey/issues/3441",
  "luna_a": {
    "elapsed_ms": 6922,
    "model": "gpt-5.6-luna",
    "reasoning_effort": "medium",
    "response": {
      "affected_scope": "valkey-skills repository",
      "ambiguity": "The transfer or recreation is recommended but not shown as decided or implemented.",
      "announced_on": "2026-04-03",
      "body_patch_relation": "body_only",
      "confidence": 0.98,
      "effective_on": null,
      "event_kind": "foundation_transfer",
      "power_changes": [
        {
          "actor": "valkey-io",
          "change_status": "proposed",
          "direction": "added",
          "evidence_refs": [
            {
              "quote": "Transfer or recreate as `valkey-io/valkey-skills`.",
              "source_id": "body"
            }
          ],
          "right_kind": "own",
          "scope": "repository under valkey-io",
          "target": "valkey-skills"
  ...

{
  "record_id": "valkey-github-issue-4276",
  "source_url": "https://github.com/valkey-io/valkey/issues/4276",
  "luna_a": {
    "elapsed_ms": 8536,
    "model": "gpt-5.6-luna",
    "reasoning_effort": "medium",
    "response": {
      "affected_scope": "proposed valkey-io/valkey-samples repository",
      "ambiguity": "The source is explicitly an RFC before implementation and is truncated during the governance-model section, so it does not provide a complete, grounded rights change or evidence of implementation.",
      "announced_on": "2026-07-28",
      "body_patch_relation": "body_only",
      "confidence": 0.9,
      "effective_on": null,
      "event_kind": "control_rights",
      "power_changes": [],
      "record_class": "abstain",
      "title": "[NEW] Valkey Samples Repository"
    },
    "schema_valid": true,
    "validation_errors": []
  },
  "luna_b": {
    "elapsed_ms": 5386,
    "model": "gpt-5.6-luna",
    "reasoning_effort": "medium",
    "response": {
      ...

<path>/home/byk/Code/institutional-transition-lab/cases/review/oss-governance-adjudication-v1/fragments/opentofu-a2.json</path>
<type>file</type>
<content>
1: {
2:   "schema_version": 1,
3:   "design_status": "performance_blinded_llm_assisted_source_adjudication",
4:   "reviewers": [
5:     {
6:       "reviewer_id": "opencode-sol-opentofu-a2",
7:       "reviewer_type": "llm",
8:       "model": "openai/gpt-5.6-sol",
9:       "role": "source_adjudicator",
10:       "assistance": "Source-first review of four frozen OpenTofu records"
11:     }
12:   ],
13:   "records": [
14:     {
15:       "record_id": "opentofu-github-issue-340",
16:       "source_url": "https://github.com/opentofu/opentofu/issues/340",
17:       "decision": "accept",
18:       "accepted_from": "luna_b",
19:       "reviewer_ids": [
20:         "opencode-sol-opentofu-a2"
21:       ],
22:       "source_audit": {
23:         "inspected_before_codings": true,
24:         "source_ids": [
25:           "body"
26:         ...

[
  {
    "entity_id": "valkey",
    "evidence_bounds": {
      "files_listing_complete": null,
      "patch_selection_truncated": false,
      "patch_unavailable_count": 0,
      "source_text_truncated": false
    },
    "published_on": "2025-12-22",
    "publisher": "valkey-io/valkey",
    "record_id": "valkey-github-issue-2961",
    "source_type": "github_issue",
    "source_url": "https://github.com/valkey-io/valkey/issues/2961",
    "sources": [
      {
        "filename": null,
        "kind": "github_body",
        "source_id": "body",
        "text": "[NEW] Valkey kernel-level hot key detection function\n\n**The problem/use-case that the feature addresses**\n\nIn Valkey, hot keys (high-frequency access keys) severely impact system stability: single hot key over-access overloads its node (high CPU, increased latency), becomes a server bottleneck even triggering cascading failures, and may cause cache penetration hitting backend databases in extreme cases. ...

[
  {
    "record_id": "valkey-github-issue-2961",
    "luna_a": {
      "affected_scope": "Valkey hot key detection and processing",
      "ambiguity": null,
      "announced_on": "2025-12-22",
      "body_patch_relation": "body_only",
      "confidence": 0.98,
      "effective_on": null,
      "event_kind": "product",
      "power_changes": [],
      "record_class": "control_event",
      "title": "Proposal for Valkey kernel-level hot key detection"
    },
    "luna_a_schema_valid": true,
    "luna_b": {
      "affected_scope": "Valkey hot key detection, processing, and monitoring",
      "ambiguity": null,
      "announced_on": "2025-12-22",
      "body_patch_relation": "not_applicable",
      "confidence": 0.98,
      "effective_on": null,
      "event_kind": "product",
      "power_changes": [],
      "record_class": "control_event",
      "title": "Proposal for kernel-level hot key detection in Valkey"
    },
    "luna_b_schema_valid": true,
    "terra_advisory": {
      ...

No files found

Found 4 matches
/home/byk/Code/institutional-transition-lab/src/institution_lab/governance_adjudication.py:
  Line 539: def validate_adjudication_fragment(


/home/byk/Code/institutional-transition-lab/tests/test_governance_adjudication.py:
  Line 17: 	validate_adjudication_fragment,

  Line 715: 	assert validate_adjudication_fragment(fragment, documents, coding_package, schema) == []

  Line 727: 	errors = validate_adjudication_fragment(fragment, documents, coding_package, schema)

<path>/home/byk/Code/institutional-transition-lab/src/institution_lab/governance_adjudication.py</path>
<type>file</type>
<content>
500: 	)
501: 	unresolved = [
502: 		record.get("record_id")
503: 		for record in adjudication_rows
504: 		if isinstance(record, dict) and record.get("decision") == "abstain"
505: 	]
506: 	record_decisions = [
507: 		{
508: 			"record_id": record.get("record_id"),
509: 			"decision": record.get("decision"),
510: 			"final_class": (
511: 				record["final_coding"].get("record_class")
512: 				if isinstance(record.get("final_coding"), dict)
513: 				else None
514: 			),
515: 			"reviewer_ids": record.get("reviewer_ids"),
516: 			"evidence_limitations": record.get("evidence_limitations"),
517: 		}
518: 		for record in adjudication_rows
519: 		if isinstance(record, dict)
520: 	]
521: 	graph_edge_revisions = [
522: 		{"record_id": record.get("record_id"), **record["graph_edge_revision"]}
523: 		for record in adjudication_rows
524: 		if isinstance(record, dict) ...

<path>/home/byk/Code/institutional-transition-lab/src/institution_lab/governance_adjudication.py</path>
<type>file</type>
<content>
1: from __future__ import annotations
2: 
3: import argparse
4: import hashlib
5: import json
6: import zipfile
7: from collections import Counter
8: from pathlib import Path
9: from typing import Any
10: 
11: from jsonschema import Draft202012Validator, FormatChecker
12: 
13: from institution_lab.governance_coding import validate_response
14: 
15: DECISIONS = {"accept", "revise", "reject", "abstain"}
16: INSTITUTIONAL_CLASSES = {
17: 	"effective_institutional_change",
18: 	"announced_institutional_change",
19: 	"proposal_only",
20: }
21: REVIEWER_TYPES = {"human", "llm", "human_llm_assisted"}
22: REVIEWER_ROLES = {"source_adjudicator", "evidence_auditor", "synthesizer"}
23: RESPONSE_SOURCES = {"luna_a", "luna_b", "terra_advisory"}
24: REQUIRED_INPUT_PINS = {
25: 	"workflow_run_id",
26: 	"artifact_id",
27: 	"artifact_sha256",
28: 	"documents_sha256",
29: ...