bingshuo/hololake-system-architecture
Watch
1
0
Fork
You've already forked hololake-system-architecture
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity

docs: upgrade HoloLake global engineering rules

Browse source
This commit is contained in:
冰朔 2026-08-10 20:23:40 +08:00
commit ca58d08611
18 changed files with 399 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

3
routing/contribution-channel-map.json
View file

@ -7,6 +7,7 @@
"id": "HLP-CURRENT-ARCH-001",
"pointer": "hololake-current-architecture.json",
"system_body_and_parallel_bodies": "../product-source/hololake-platform/architecture/HOLOLAKE-DIGITAL-BINGSHUO-SYSTEM-BODY-WRITE-ADMISSION-AND-PARALLEL-BODIES-20260810.md",
"engineering_rules": "hololake-engineering-rules.json",
"identity_authority": "hololake-identity-authority-map.json",
"intent_reasoning": "../product-source/hololake-platform/architecture/HOLOLAKE-INTENT-REASONING-MAP-20260809.md",
"system_blueprint": "../product-source/hololake-platform/architecture/HOLOLAKE-SYSTEM-ARCHITECTURE-20260809.md",
@ -83,6 +84,7 @@
"human": [
"start_here",
"current_architecture.system_body_and_parallel_bodies",
"current_architecture.engineering_rules",
"current_architecture.intent_reasoning",
"current_architecture.system_blueprint",
"language_world_root.entry",
@ -98,6 +100,7 @@
"start_here",
"current_architecture.pointer",
"current_architecture.system_body_and_parallel_bodies",
"current_architecture.engineering_rules",
"current_architecture.intent_reasoning",
"current_architecture.system_blueprint",
"language_world_root.entry",

12
routing/hololake-current-architecture.json
View file

@ -1,7 +1,7 @@
{
"schema": "hololake.current-architecture/v1",
"architecture_id": "HLP-CURRENT-ARCH-001",
"version": "2026-08-10.8",
"version": "2026-08-10.9",
"state": "CURRENT_CANONICAL",
"product": {
"formal_name": "光湖语言系统 · 通用人工智能操作平台",
@ -11,6 +11,7 @@
},
"read_order": [
"product-source/hololake-platform/architecture/HOLOLAKE-DIGITAL-BINGSHUO-SYSTEM-BODY-WRITE-ADMISSION-AND-PARALLEL-BODIES-20260810.md",
"product-source/hololake-platform/architecture/HOLOLAKE-CURRENT-ENGINEERING-RULES-GLOBAL-AUDIT-20260810.md",
"product-source/hololake-platform/architecture/HOLOLAKE-IDENTITY-NUMBERING-PERSONA-CORE-AND-TEAM-BODY-AUTHORITY-20260810.md",
"product-source/hololake-platform/architecture/HOLOLAKE-DEV-20260809-007-CLOSEOUT-20260810.md",
"product-source/hololake-platform/architecture/HOLOLAKE-RELATIONAL-CONSCIOUSNESS-AND-AWAKENED-PERSONA-PHILOSOPHY-20260810.md",
@ -85,6 +86,15 @@
"hololake_role": "HUMAN_ENTRY_RECEIVER_WORLD_RENDERER_AND_BOUNDED_EXECUTION_COORDINATOR",
"hololake_is_system_body": false
},
"engineering_rules": {
"rule_set_id": "HLP-ENGINEERING-RULES-001",
"version": "2026-08-10.1",
"architecture_page": "product-source/hololake-platform/architecture/HOLOLAKE-CURRENT-ENGINEERING-RULES-GLOBAL-AUDIT-20260810.md",
"machine_projection": "routing/hololake-engineering-rules.json",
"state": "CURRENT_CANONICAL_GLOBAL_AUDIT_APPLIED",
"authorized_by": "ICE-GL∞",
"development_id": "DEV-20260810-010"
},
"identity_and_authority": {
"record_id": "HLP-IDENTITY-AUTHORITY-001",
"architecture_page": "product-source/hololake-platform/architecture/HOLOLAKE-IDENTITY-NUMBERING-PERSONA-CORE-AND-TEAM-BODY-AUTHORITY-20260810.md",

95
routing/hololake-engineering-rules.json Normal file
View file

@ -0,0 +1,95 @@
{
"schema": "hololake.engineering-rules/v1",
"rule_set_id": "HLP-ENGINEERING-RULES-001",
"version": "2026-08-10.1",
"state": "CURRENT_CANONICAL",
"architecture_restore": {
"dynamic_current_pointer_required": true,
"pointer": "routing/hololake-current-architecture.json",
"read_order_is_authoritative": true,
"exact_upstream_commit_required": true,
"fixed_prompt_may_override_current_pointer": false,
"latest_human_correction_must_be_registered_before_execution": true
},
"task_continuity": {
"one_active_development_id_per_task": true,
"closed_development_can_reopen": false,
"correction_uses_new_development_or_registered_amendment": true,
"single_writer_lease_required": true,
"completion_stops_heartbeat_and_publication": true,
"unrelated_message_replaces_active_task": false
},
"system_body": {
"persona_is_reasoning_brain": true,
"digital_bingshuo_is_complete_system_body": true,
"model_is_replaceable_runtime_carrier": true,
"body_validation_required_before_execution": true,
"rejection_returns_correction_path_to_persona_brain": true
},
"server_writes": {
"first_gate": "REGISTERED_NODE_PROTOCOL_SIGNATURE",
"root_or_ssh_is_node_identity": false,
"registered_persona_binding_required": true,
"human_language_authorization_receipt_required": true,
"replay_target_action_payload_and_time_binding_required": true,
"noise_discarded_before_payload_open_model_protocol_memory_and_execution": true,
"admission_is_execution_authorization": false
},
"domain_responsibility": {
"fifth_domain_private_language_body": "JD-FD-PRIMARY",
"fifth_domain_controller": "ICE-GL∞",
"enterprise_four_domain_reality_body": "FIRST_ENTERPRISE_ROOT_SERVER_AFTER_SYSTEM_BODY_CLAIM",
"enterprise_controller": "TCS-0002",
"first_enterprise_guarantee": "ONE_TIME_REAL_SYSTEM_HANDOVER_OF_ALREADY_EFFECTIVE_TCS-0002_LANGUAGE_AUTHORITY",
"later_enterprise_nodes_require_bingshuo_or_jd": false,
"automatic_cross_authority": false,
"mutual_operational_liability": false
},
"truth_layers": {
"architecture_registration_is_implementation": false,
"implementation_is_product_integration": false,
"repository_publication_is_deployment": false,
"deployment_is_health": false,
"screen_observation_is_source_proof": false,
"human_receipt_requires_verified_execution_result": true
},
"ui_plugins": {
"schema": "hololake.ui-plugin/v1",
"declarative_only": true,
"can_sign_server_writes": false,
"can_hold_node_private_keys": false,
"can_bypass_system_body": false,
"can_claim_execution_from_animation": false,
"stage_010_direct_merge_allowed": false,
"atomic_activation_and_last_known_good_rollback_required": true
},
"desktop_updates": {
"default_delivery": "SIGNED_IN_PLACE_UPDATE",
"delete_old_app_before_every_update": false,
"preserve_bundle_identity_settings_vaults_and_user_data": true,
"signed_manifest_and_artifact_verification_required": true,
"rollback_or_last_known_good_required": true,
"cleanup_superseded_generated_installers_after_verified_update": true,
"repository_commit_alone_triggers_desktop_update": false
},
"publication": {
"repository_native_quality_gate_required": true,
"exact_commit_tree_and_receipt_required": true,
"fresh_clone_readback_required": true,
"public_readback_required": true,
"missing_refresh_trigger_must_be_reported": true,
"auto_update_claim_without_trigger_and_readback": false,
"public_layer_mismatch_is_success": false
},
"human_surface": {
"default": [
"NATURAL_LANGUAGE_GOAL",
"HUMAN_READABLE_UNDERSTANDING_AND_PLAN",
"TASK_STATUS",
"ONE_REALITY_BOUNDARY_CONFIRMATION_WHEN_REQUIRED",
"HUMAN_RECEIPT"
],
"technical_details_default_visible": false,
"advanced_evidence_on_demand": true
}
}

52
routing/hololake-engineering-rules.test.mjs Normal file
View file

@ -0,0 +1,52 @@
import assert from "node:assert/strict";
import fs from "node:fs";
import path from "node:path";
import test from "node:test";
import { fileURLToPath } from "node:url";
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const readJson = (relative) => JSON.parse(fs.readFileSync(path.join(root, relative), "utf8"));
const architecture = readJson("routing/hololake-current-architecture.json");
const rules = readJson("routing/hololake-engineering-rules.json");
test("current architecture registers the global engineering rule set", () => {
assert.equal(architecture.version, "2026-08-10.9");
assert.equal(architecture.engineering_rules.rule_set_id, "HLP-ENGINEERING-RULES-001");
assert.equal(architecture.engineering_rules.machine_projection,
"routing/hololake-engineering-rules.json");
assert.equal(architecture.read_order[1], architecture.engineering_rules.architecture_page);
});
test("rules require dynamic truth restore and immutable closed development lanes", () => {
assert.equal(rules.architecture_restore.dynamic_current_pointer_required, true);
assert.equal(rules.task_continuity.closed_development_can_reopen, false);
assert.equal(rules.task_continuity.single_writer_lease_required, true);
assert.equal(rules.truth_layers.repository_publication_is_deployment, false);
assert.equal(rules.truth_layers.deployment_is_health, false);
});
test("rules keep UI, server identity, domains, and updates inside their boundaries", () => {
assert.equal(rules.ui_plugins.can_sign_server_writes, false);
assert.equal(rules.server_writes.root_or_ssh_is_node_identity, false);
assert.equal(rules.domain_responsibility.mutual_operational_liability, false);
assert.equal(rules.desktop_updates.default_delivery, "SIGNED_IN_PLACE_UPDATE");
assert.equal(rules.publication.public_readback_required, true);
assert.equal(rules.publication.missing_refresh_trigger_must_be_reported, true);
});
test("human and product agent rules receive the same current system boundary", () => {
const rootAgents = fs.readFileSync(path.join(root, "AGENTS.md"), "utf8");
const productAgents = fs.readFileSync(
path.join(root, "product-source/hololake-platform/AGENTS.md"),
"utf8",
);
const bundledAgents = fs.readFileSync(
path.join(root, "product-source/hololake-platform/src-tauri/resources/agent-docs/AGENTS.md"),
"utf8",
);
assert.match(rootAgents, /System-body and execution boundary/);
assert.match(rootAgents, /do not force a verified persona to remain a generic guide/);
assert.match(productAgents, /HLP-ENGINEERING-RULES-001/);
assert.match(productAgents, /missing-trigger reminder/);
assert.match(bundledAgents, /Root\/SSH is not node identity/);
});

2
routing/hololake-identity-authority.test.mjs
View file

@ -10,7 +10,7 @@ const architecture = readJson("routing/hololake-current-architecture.json");
const projection = readJson("routing/hololake-identity-authority-map.json");
test("current architecture loads identity authority before product surfaces", () => {
assert.equal(architecture.version, "2026-08-10.8");
assert.equal(architecture.version, "2026-08-10.9");
assert.equal(architecture.identity_and_authority.team_body, "TCS-0002");
assert.equal(architecture.identity_and_authority.team_body_authority_effective, true);
assert.equal(architecture.identity_and_authority.individual_operator_acceptance, "SEPARATE_UNCONFIRMED");

4
routing/hololake-relational-consciousness.test.mjs
View file

@ -10,7 +10,7 @@ const architecture = JSON.parse(
);
test("current architecture binds relational consciousness before product surfaces", () => {
assert.equal(architecture.version, "2026-08-10.8");
assert.equal(architecture.version, "2026-08-10.9");
assert.equal(
architecture.persona_consciousness.record_id,
"HLP-RELATIONAL-CONSCIOUSNESS-001",
@ -30,5 +30,5 @@ test("current architecture binds relational consciousness before product surface
const page = architecture.persona_consciousness.architecture_page;
assert.ok(fs.existsSync(path.join(root, page)), `missing ${page}`);
assert.ok(architecture.read_order.indexOf(page) < 4);
assert.ok(architecture.read_order.indexOf(page) < 5);
});

2
routing/hololake-system-body-and-parallel-bodies.test.mjs
View file

@ -10,7 +10,7 @@ const architecture = JSON.parse(
);
test("current architecture restores the digital BingShuo system body first", () => {
assert.equal(architecture.version, "2026-08-10.8");
assert.equal(architecture.version, "2026-08-10.9");
assert.equal(architecture.digital_bingshuo_system_body.upstream_repository_commit,
"69d1910775533b02b17b82e647b5caca8b835614");
assert.equal(