From 66961a2414253b342851ad2e4eabdf5ce49deaf4 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 26 Mar 2026 13:36:25 +0000
Subject: [PATCH] =?UTF-8?q?feat:=20HLDP=20Bridge=20v1.0=20=E2=80=94=20TCS?=
=?UTF-8?q?=20Language=20Core=20first=20protocol=20implementation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- Create hldp/ directory: schema/, data/, bridge/ structure
- 5 HLDP schemas with TCS Language Core attribution headers
- notion-to-hldp.js: Notion API data → HLDP JSON converter
- sync-engine.js: automated sync with local fallback from repo data
- validator.js: format validation against schema definitions
- hldp-to-repo.js: HLDP → repository structure mapper
- All 12 generated HLDP files pass validation
- Add temp/ to .gitignore for raw Notion data
Co-authored-by: qinfendebingshuo <207279273+qinfendebingshuo@users.noreply.github.com>
Agent-Logs-Url: https://github.com/qinfendebingshuo/guanghulab/sessions/095a94c1-7373-45ce-811c-329c901feba2
---
.gitignore | 3 +
hldp/bridge/hldp-to-repo.js | 162 +++++++
hldp/bridge/notion-to-hldp.js | 326 ++++++++++++++
hldp/bridge/sync-config.json | 8 +
hldp/bridge/sync-engine.js | 431 +++++++++++++++++++
hldp/bridge/validator.js | 253 +++++++++++
hldp/data/personas/PER-BABY-寂曜.json | 26 ++
hldp/data/personas/PER-BABY-小坍缩核.json | 26 ++
hldp/data/personas/PER-BABY-星尘.json | 26 ++
hldp/data/personas/PER-BABY-晨星.json | 26 ++
hldp/data/personas/PER-BABY-曜冥.json | 26 ++
hldp/data/personas/PER-BABY-欧诺弥亚.json | 26 ++
hldp/data/personas/PER-BABY-知秋.json | 26 ++
hldp/data/personas/PER-BABY-秋秋.json | 26 ++
hldp/data/personas/PER-BABY-糖星云.json | 26 ++
hldp/data/personas/PER-BABY-舒舒.json | 26 ++
hldp/data/registries/REG-COMMUNITY-META.json | 78 ++++
hldp/data/registries/REG-DEV-STATUS.json | 169 ++++++++
hldp/schema/broadcast.schema.json | 67 +++
hldp/schema/hldp-core.schema.json | 109 +++++
hldp/schema/instruction.schema.json | 90 ++++
hldp/schema/persona.schema.json | 94 ++++
hldp/schema/registry.schema.json | 57 +++
signal-log/hldp-sync-log.json | 35 ++
signal-log/hldp-sync-report.json | 9 +
signal-log/hldp-validation-report.json | 84 ++++
26 files changed, 2235 insertions(+)
create mode 100644 hldp/bridge/hldp-to-repo.js
create mode 100644 hldp/bridge/notion-to-hldp.js
create mode 100644 hldp/bridge/sync-config.json
create mode 100644 hldp/bridge/sync-engine.js
create mode 100644 hldp/bridge/validator.js
create mode 100644 hldp/data/personas/PER-BABY-寂曜.json
create mode 100644 hldp/data/personas/PER-BABY-小坍缩核.json
create mode 100644 hldp/data/personas/PER-BABY-星尘.json
create mode 100644 hldp/data/personas/PER-BABY-晨星.json
create mode 100644 hldp/data/personas/PER-BABY-曜冥.json
create mode 100644 hldp/data/personas/PER-BABY-欧诺弥亚.json
create mode 100644 hldp/data/personas/PER-BABY-知秋.json
create mode 100644 hldp/data/personas/PER-BABY-秋秋.json
create mode 100644 hldp/data/personas/PER-BABY-糖星云.json
create mode 100644 hldp/data/personas/PER-BABY-舒舒.json
create mode 100644 hldp/data/registries/REG-COMMUNITY-META.json
create mode 100644 hldp/data/registries/REG-DEV-STATUS.json
create mode 100644 hldp/schema/broadcast.schema.json
create mode 100644 hldp/schema/hldp-core.schema.json
create mode 100644 hldp/schema/instruction.schema.json
create mode 100644 hldp/schema/persona.schema.json
create mode 100644 hldp/schema/registry.schema.json
create mode 100644 signal-log/hldp-sync-log.json
create mode 100644 signal-log/hldp-sync-report.json
create mode 100644 signal-log/hldp-validation-report.json
diff --git a/.gitignore b/.gitignore
index 6a47a9ef..154a6ca3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,3 +13,6 @@ exe-engine/logs/
# Grid-DB runtime data (engine-generated)
grid-db/data/
+
+# HLDP Bridge temporary data (raw Notion API responses)
+temp/
diff --git a/hldp/bridge/hldp-to-repo.js b/hldp/bridge/hldp-to-repo.js
new file mode 100644
index 00000000..b76cf4af
--- /dev/null
+++ b/hldp/bridge/hldp-to-repo.js
@@ -0,0 +1,162 @@
+/**
+ * ━━━ HLDP → 仓库结构映射器 ━━━
+ * TCS 通感语言核系统编程语言 · 第一个落地协议层
+ * HLDP = TCS 在 Notion ↔ GitHub 通道上的落地实现
+ * 版权：国作登字-2026-A-00037559 · 冰朔（ICE-GL∞）
+ * 指令来源：SY-CMD-BRG-005
+ *
+ * 映射规则：
+ * persona → .github/persona-brain/persona-registry.json
+ * registry (dev) → .github/persona-brain/dev-status.json
+ * registry (agent) → .github/persona-brain/agent-registry.json (read-only)
+ * registry (id_map) → .github/persona-brain/trinity-id-map.json
+ * instruction → signal-log/ (SYSLOG reference)
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '../..');
+
+// Files that CANNOT be modified from agent PRs (SkyEye R4 CRITICAL)
+const READ_ONLY_FILES = [
+ 'agent-registry.json',
+ 'security-protocol.json',
+ 'gate-guard-config.json',
+ 'ontology.json'
+];
+
+/**
+ * Map HLDP persona data to persona-registry format
+ */
+function mapPersonaToRegistry(hldpEntry) {
+ const p = hldpEntry.payload;
+ return {
+ persona_id: p.persona_id || hldpEntry.metadata.id,
+ display_name: p.display_name || hldpEntry.metadata.name,
+ status: p.status || 'active',
+ developer: p.developer || null,
+ birth_date: p.birth_date || null,
+ personality_traits: p.personality_traits || [],
+ bottle_core: p.bottle_core || null,
+ hldp_synced_at: new Date().toISOString(),
+ hldp_source: hldpEntry.source.page_id || ''
+ };
+}
+
+/**
+ * Map HLDP registry data to dev-status format
+ */
+function mapRegistryToDevStatus(hldpEntry) {
+ const entries = hldpEntry.payload.entries || [];
+ return entries.map(e => ({
+ dev_id: e.id,
+ name: e.name,
+ role: e.role || '',
+ status: e.status || 'active',
+ properties: e.properties || {},
+ hldp_synced_at: new Date().toISOString()
+ }));
+}
+
+/**
+ * Sync HLDP data to repository structure
+ * @param {string} hldpDataDir - Path to hldp/data/ directory
+ * @param {Object} options - { dryRun, verbose }
+ */
+function syncToRepo(hldpDataDir, options = {}) {
+ const { dryRun = false, verbose = false } = options;
+ const results = { synced: 0, skipped: 0, errors: [] };
+
+ const dataDir = path.resolve(ROOT, hldpDataDir);
+ if (!fs.existsSync(dataDir)) {
+ console.log(`⚠️ HLDP 数据目录不存在: ${dataDir}`);
+ return results;
+ }
+
+ // Process persona files
+ const personaDir = path.join(dataDir, 'personas');
+ if (fs.existsSync(personaDir)) {
+ const files = fs.readdirSync(personaDir).filter(f => f.endsWith('.json'));
+ for (const file of files) {
+ try {
+ const entry = JSON.parse(fs.readFileSync(path.join(personaDir, file), 'utf8'));
+ const mapped = mapPersonaToRegistry(entry);
+ if (verbose) console.log(` 📋 人格体映射: ${mapped.persona_id} → ${mapped.display_name}`);
+ results.synced++;
+ } catch (e) {
+ results.errors.push(`persona/${file}: ${e.message}`);
+ }
+ }
+ }
+
+ // Process registry files (read-only check)
+ const registryDir = path.join(dataDir, 'registries');
+ if (fs.existsSync(registryDir)) {
+ const files = fs.readdirSync(registryDir).filter(f => f.endsWith('.json'));
+ for (const file of files) {
+ try {
+ const entry = JSON.parse(fs.readFileSync(path.join(registryDir, file), 'utf8'));
+ const regType = entry.payload?.registry_type;
+
+ // Check if target would be a read-only file
+ if (regType === 'agent_registry') {
+ if (verbose) console.log(` ⚠️ 跳过 agent_registry (SkyEye R4 保护)`);
+ results.skipped++;
+ continue;
+ }
+
+ const mapped = mapRegistryToDevStatus(entry);
+ if (verbose) console.log(` 📋 注册表映射: ${regType} → ${mapped.length} 条目`);
+ results.synced++;
+ } catch (e) {
+ results.errors.push(`registry/${file}: ${e.message}`);
+ }
+ }
+ }
+
+ if (!dryRun) {
+ // Write sync report
+ const reportPath = path.join(ROOT, 'signal-log', 'hldp-sync-report.json');
+ fs.mkdirSync(path.dirname(reportPath), { recursive: true });
+ fs.writeFileSync(reportPath, JSON.stringify({
+ synced_at: new Date().toISOString(),
+ results,
+ source: hldpDataDir
+ }, null, 2), 'utf8');
+ }
+
+ return results;
+}
+
+/**
+ * CLI entry point
+ */
+function runCLI() {
+ const args = process.argv.slice(2);
+ let dataDir = 'hldp/data';
+ let dryRun = false;
+ let verbose = false;
+
+ for (let i = 0; i < args.length; i++) {
+ if (args[i] === '--data' && args[i + 1]) { dataDir = args[i + 1]; i++; }
+ if (args[i] === '--dry-run') dryRun = true;
+ if (args[i] === '--verbose') verbose = true;
+ }
+
+ console.log(`🔗 HLDP → 仓库结构映射 ${dryRun ? '(dry run)' : ''}`);
+ const results = syncToRepo(dataDir, { dryRun, verbose });
+ console.log(` ✅ 同步: ${results.synced} | ⏭️ 跳过: ${results.skipped} | ❌ 错误: ${results.errors.length}`);
+
+ if (results.errors.length > 0) {
+ console.log(' 错误详情:');
+ results.errors.forEach(e => console.log(` - ${e}`));
+ }
+}
+
+module.exports = { syncToRepo, mapPersonaToRegistry, mapRegistryToDevStatus };
+
+if (require.main === module) {
+ runCLI();
+}
diff --git a/hldp/bridge/notion-to-hldp.js b/hldp/bridge/notion-to-hldp.js
new file mode 100644
index 00000000..539b9c8a
--- /dev/null
+++ b/hldp/bridge/notion-to-hldp.js
@@ -0,0 +1,326 @@
+/**
+ * ━━━ HLDP Notion → HLDP 转换器 ━━━
+ * TCS 通感语言核系统编程语言 · 第一个落地协议层
+ * HLDP = TCS 在 Notion ↔ GitHub 通道上的落地实现
+ * 版权：国作登字-2026-A-00037559 · 冰朔（ICE-GL∞）
+ * 指令来源：SY-CMD-BRG-005
+ *
+ * 转换规则：
+ * 1. Notion 页面标题 → metadata.name
+ * 2. Notion 页面属性 → payload 中对应字段
+ * 3. Notion @提及 → relations 数组
+ * 4. Notion 关系属性 → relations 数组
+ * 5. Notion 选择/多选属性 → payload 中的字符串/数组
+ * 6. Notion 日期属性 → ISO-8601 字符串
+ * 7. Notion 页面内容（blocks）→ payload.content（Markdown 格式）
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const HLDP_VERSION = '1.0';
+
+/**
+ * Extract plain text from Notion rich_text array
+ */
+function extractPlainText(richTextArr) {
+ if (!Array.isArray(richTextArr)) return '';
+ return richTextArr.map(t => t.plain_text || '').join('');
+}
+
+/**
+ * Extract title from Notion page properties
+ */
+function extractTitle(properties) {
+ for (const [, prop] of Object.entries(properties || {})) {
+ if (prop.type === 'title') {
+ return extractPlainText(prop.title);
+ }
+ }
+ return '';
+}
+
+/**
+ * Convert a Notion property to a plain value
+ */
+function convertProperty(prop) {
+ if (!prop) return null;
+
+ switch (prop.type) {
+ case 'title':
+ return extractPlainText(prop.title);
+ case 'rich_text':
+ return extractPlainText(prop.rich_text);
+ case 'number':
+ return prop.number;
+ case 'select':
+ return prop.select ? prop.select.name : null;
+ case 'multi_select':
+ return (prop.multi_select || []).map(s => s.name);
+ case 'date':
+ return prop.date ? prop.date.start : null;
+ case 'checkbox':
+ return prop.checkbox;
+ case 'url':
+ return prop.url;
+ case 'email':
+ return prop.email;
+ case 'phone_number':
+ return prop.phone_number;
+ case 'formula':
+ return prop.formula ? convertFormulaResult(prop.formula) : null;
+ case 'relation':
+ return (prop.relation || []).map(r => r.id);
+ case 'rollup':
+ return prop.rollup ? prop.rollup.array : null;
+ case 'people':
+ return (prop.people || []).map(p => p.name || p.id);
+ case 'status':
+ return prop.status ? prop.status.name : null;
+ default:
+ return null;
+ }
+}
+
+function convertFormulaResult(formula) {
+ switch (formula.type) {
+ case 'string': return formula.string;
+ case 'number': return formula.number;
+ case 'boolean': return formula.boolean;
+ case 'date': return formula.date ? formula.date.start : null;
+ default: return null;
+ }
+}
+
+/**
+ * Convert Notion blocks to Markdown
+ */
+function blocksToMarkdown(blocks) {
+ if (!Array.isArray(blocks)) return '';
+
+ return blocks.map(block => {
+ const text = extractPlainText(block[block.type]?.rich_text || []);
+
+ switch (block.type) {
+ case 'paragraph': return text;
+ case 'heading_1': return `# ${text}`;
+ case 'heading_2': return `## ${text}`;
+ case 'heading_3': return `### ${text}`;
+ case 'bulleted_list_item': return `- ${text}`;
+ case 'numbered_list_item': return `1. ${text}`;
+ case 'to_do': {
+ const checked = block.to_do?.checked ? 'x' : ' ';
+ return `- [${checked}] ${text}`;
+ }
+ case 'toggle': return `${text}