foundation: start native language reality engineering root

parts/HLP-PART-0011/PART.hldp

@@ -0,0 +1,9 @@
+schema: hololake.numbered-part/v1
+id: HLP-PART-0011
+display_name: 原生知识库与编号思维索引
+state: DONOR_BYTES_EXTRACTED
+source_commit: 2e48b7d7686554454b6ee69bcdbd01eb68bff401
+payload_sha256: 8c421fb8c7498f71612d2be2a76a8cd5617ee49e02fb59c4cf3ce87944a8648a
+payload_files: 3
+native_acceptance: PENDING
+truth_boundary: PUBLIC_SIGNED_RUNTIME_ACCEPTANCE_FALSE

parts/HLP-PART-0011/payload/product-source/hololake-native-desktop/contracts/numbered-knowledge-protocol.json

@@ -0,0 +1,63 @@
+{
+  "schema": "hololake.numbered-knowledge-protocol/v1",
+  "record_id": "HLP-KB-NUMBER-PROTOCOL-001",
+  "state": "NATIVE_INDEX_IMPLEMENTED_LEGACY_THOUGHT_MODELING_PENDING",
+  "numbering_system": "HLP-KB",
+  "storage": {
+    "kind": "AUTHENTICATED_ACCOUNT_LOCAL_SQLITE",
+    "relative_path": ".hololake/numbered-knowledge-index.sqlite3",
+    "original_documents_rewritten": false,
+    "original_sha256_preserved": true
+  },
+  "page_header": {
+    "schema": "hololake.numbered-knowledge-page-header/v1",
+    "required_fields": [
+      "number",
+      "numberingSystem",
+      "parentNumber",
+      "path",
+      "mappingTerms",
+      "thoughtSummary",
+      "children",
+      "source",
+      "version",
+      "contentSha256",
+      "state",
+      "formalRouting"
+    ],
+    "thought_summary": {
+      "required_fields": ["trigger", "emergence", "lock", "why"],
+      "answer_prefix_or_plain_truncation_allowed": false
+    }
+  },
+  "numbers": {
+    "document_pattern": "HLP-KB-DOC-{SHA256(schema:source:path)[0..16].upper}",
+    "group_pattern": "HLP-KB-GRP-{SHA256(schema:source:GROUP:parentPath)[0..16].upper}",
+    "stable_across_content_edits": true,
+    "collision_boundary": "SOURCE_AND_NORMALIZED_PATH",
+    "different_owner_same_number_fails_closed": true
+  },
+  "routing": {
+    "flow": [
+      "HUMAN_FUZZY_SEMANTICS",
+      "INDEX_TOP_3_NUMBERED_CANDIDATES",
+      "RESPONDER_EXACT_DOCUMENT_NUMBER_SELECTION",
+      "PROMPTER_EXACT_ORIGINAL_PAGE_FETCH"
+    ],
+    "regular_search_reads_full_document_body": false,
+    "exact_read_accepts_path_guess": false,
+    "candidate_limit": 3
+  },
+  "migration": {
+    "legacy_default_state": "PENDING_THOUGHT_INDEX",
+    "pending_mapping_terms_are_mechanical_not_causal_claims": true,
+    "pending_page_may_fabricate_thought_summary": false,
+    "ready_requires_all_thought_summary_fields": true,
+    "missing_source_state": "SOURCE_MISSING"
+  },
+  "authority": {
+    "page_content_is_evidence_only": true,
+    "indexing_grants_persona_binding": false,
+    "indexing_grants_execution_authority": false
+  }
+}

parts/HLP-PART-0011/payload/product-source/hololake-native-desktop/scripts/numbered-knowledge-protocol.test.mjs

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import test from 'node:test'
+
+const read = (path) => readFileSync(new URL(`../${path}`, import.meta.url), 'utf8')
+
+test('knowledge pages share one stable numbered header protocol without rewriting originals', () => {
+  const contract = JSON.parse(read('contracts/numbered-knowledge-protocol.json'))
+  const runtime = read('src-tauri/src/knowledge_base.rs')
+
+  assert.equal(contract.numbering_system, 'HLP-KB')
+  assert.equal(contract.storage.original_documents_rewritten, false)
+  assert.equal(contract.storage.original_sha256_preserved, true)
+  assert.deepEqual(contract.page_header.thought_summary.required_fields, ['trigger', 'emergence', 'lock', 'why'])
+  assert.equal(contract.migration.legacy_default_state, 'PENDING_THOUGHT_INDEX')
+  assert.equal(contract.migration.pending_page_may_fabricate_thought_summary, false)
+  assert.equal(contract.routing.regular_search_reads_full_document_body, false)
+  assert.equal(contract.routing.exact_read_accepts_path_guess, false)
+  assert.equal(contract.numbers.different_owner_same_number_fails_closed, true)
+  assert.match(runtime, /numbered-knowledge-index\.sqlite3/)
+  assert.match(runtime, /HLP-KB-DOC-/)
+  assert.match(runtime, /read_numbered_document_at/)
+  assert.match(runtime, /HOLOLAKE_KNOWLEDGE_NUMBER_COLLISION/)
+})