From 327ff4c9c7af6f5182e6f592f2c72ea7eeb97bef Mon Sep 17 00:00:00 2001 From: Lars Date: Wed, 21 Jan 2026 07:17:29 +0100 Subject: [PATCH] Refactor analysis policies and update chain roles and templates - Removed the audit section from analysis policies for simplification. - Updated chain roles to version 0.3.1, refining descriptions and edge types for clarity and consistency. - Enhanced chain templates by removing redundant node types and improving allowed node type definitions. - Revised graph schema documentation to clarify edge type definitions and improve overall structure. --- Dictionary/analysis_policies.yaml | 7 - Dictionary/chain_roles.yaml | 89 +------- Dictionary/chain_templates.yaml | 6 +- Dictionary/graph_schema.md | 338 ++++++++++++++++++++---------- 4 files changed, 238 insertions(+), 202 deletions(-) diff --git a/Dictionary/analysis_policies.yaml b/Dictionary/analysis_policies.yaml index 30b1087..516d8cc 100644 --- a/Dictionary/analysis_policies.yaml +++ b/Dictionary/analysis_policies.yaml @@ -13,10 +13,3 @@ profiles: weak_chain_roles: info unmapped_edge_types: warn missing_slot_*: warn - - audit: - severities: - missing_link_constraints: warn - weak_chain_roles: info - unmapped_edge_types: error - missing_slot_*: warn diff --git a/Dictionary/chain_roles.yaml b/Dictionary/chain_roles.yaml index 5bef305..40075ba 100644 --- a/Dictionary/chain_roles.yaml +++ b/Dictionary/chain_roles.yaml @@ -1,29 +1,14 @@ -version: 0.2.0 -context: > - Abstraction Layer für Chain-Analyse (Obsidian Plugin): - Kanonische Edge-Typen werden stabilen Rollen zugeordnet. - Rollen bleiben wenige und stabil; Edge-Typen (Canonicals) können wachsen. - Hinweis: Aliases werden im Mindnet-System / Edge Vocabulary auf Canonicals normalisiert. - -roles: - - causal: - description: "Direkte Ursache/Wirkung oder Lösung/Problem-Beziehung." - edge_types: - - caused_by - - resulted_in - - solvesversion: 0.3.0 +version: 0.3.1 context: > Abstraction Layer für Chain-Analyse (Obsidian Plugin). Edge-Typen sind (nach Mindnet-Normalisierung) kanonisch. - Rollen dienen Template-Matching, Traversal/Scoring und Debug-Explainability. - Hinweis: Neue Rollen (temporal/epistemic/normative) beeinflussen Matching erst, - wenn Templates diese Rollen in allowed_edge_roles zulassen. + Jede kanonische Edge wird genau einer Rolle zugeordnet (keine Doppelzuordnung), + damit Role-Lookups deterministisch bleiben. roles: causal: - description: "Direkte Ursache/Wirkung bzw. Problem↔Lösung." + description: "Direkte Ursache/Wirkung oder Problem↔Lösung." edge_types: - caused_by - resulted_in @@ -49,20 +34,18 @@ roles: - has_risk provenance: - description: "Herkunft/Abstammung/Quelle (lineage)." + description: "Herkunft/Abstammung/Grundlage (lineage)." edge_types: - derived_from - source_of + - based_on + - foundation_for epistemic: description: "Begründung/Evidenz/Argumentation (Warum glaube/behaupte ich das?)." edge_types: - # bereits im Vocabulary vorhanden - references - referenced_by - - based_on - - foundation_for - # neu empfohlen (kanonisch) - supports - supported_by - contradicts @@ -71,17 +54,15 @@ roles: normative: description: "Werte/Prinzipien/Normen: Ausrichtung, Konflikt, Einhaltung, Verletzung." edge_types: - # neu empfohlen (kanonisch) - upholds - upheld_by - violates - violated_by - # symmetrisch - aligned_with - conflicts_with structural: - description: "Struktur/Komposition/Tools/Assoziation/Kompetenz (nicht per se kausal)." + description: "Struktur/Komposition/Werkzeuge/Assoziation/Kompetenz (nicht per se kausal)." edge_types: - part_of - consists_of @@ -92,62 +73,12 @@ roles: - implemented_in - implements - experienced_in - - expert_for - mastered_by - - temporal: - description: "Zeitliche Ordnung/Sequenz (keine Kausalität)." - edge_types: - - followed_by - - preceeded_by - - - solved_by - - enables_constraints: - description: "Ermöglicht, begrenzt oder ist Voraussetzung / Blockade." - edge_types: - - depends_on - - required_by - - blocks - - blocked_by - - influences: - description: "Beeinflusst/steuert ohne harte Kausalität (inkl. Risiko-Signal)." - edge_types: - - impacts - - impacted_by - - guides - - guided_by - - risk_of - - has_risk - - provenance: - description: "Herkunft/Quelle/Evidenz/Referenzen (für Rückwärtsverstehen & Begründungsketten)." - edge_types: - - derived_from - - source_of - - based_on - - foundation_for - - references - - referenced_by - - structural: - description: "Struktur/Komposition/Tools/Assoziation/Kompetenz (nicht direkt kausal, aber navigationsrelevant)." - edge_types: - - part_of - - consists_of - - uses - - used_by - - related_to - - similar_to - - implemented_in - - implements - - experienced_in - expert_for - - mastered_by + - has_expert temporal: description: "Sequenz / zeitliche Ordnung (keine Kausalität)." edge_types: - followed_by - - preceeded_by + - preceded_by diff --git a/Dictionary/chain_templates.yaml b/Dictionary/chain_templates.yaml index 9d789f8..233e45b 100644 --- a/Dictionary/chain_templates.yaml +++ b/Dictionary/chain_templates.yaml @@ -68,7 +68,7 @@ templates: - id: driver allowed_node_types: [value, principle, motivation, need, goal] - id: constraint - allowed_node_types: [risk, issue, obstacle, state, boundary] + allowed_node_types: [risk, obstacle, state, boundary] - id: decision allowed_node_types: [decision, task] - id: outcome @@ -116,7 +116,7 @@ templates: description: "Begrenzung/Problem → Anpassung/Regulation → Stabilisierung (Prinzip/Wert/Habit/Projekt)." slots: - id: constraint - allowed_node_types: [risk, issue, obstacle, state, boundary] + allowed_node_types: [risk, obstacle, state, boundary] - id: adaptation allowed_node_types: [skill, trait, habit, boundary, insight, principle] - id: stabilization @@ -158,7 +158,7 @@ templates: - id: state allowed_node_types: [state] - id: trigger - allowed_node_types: [experience, event, issue, obstacle, risk] + allowed_node_types: [experience, event, obstacle, risk] - id: response allowed_node_types: [habit, decision, task] - id: next_state_or_outcome diff --git a/Dictionary/graph_schema.md b/Dictionary/graph_schema.md index cf8f195..be30ba1 100644 --- a/Dictionary/graph_schema.md +++ b/Dictionary/graph_schema.md @@ -4,179 +4,291 @@ title: Graph Topology & Preferences (Atomic) type: reference status: system system_role: config -context: "Explizites Regelwerk für bidirektionale Notiz-Verbindungen. Enthält migrierte edge_defaults aus types.yaml. WP-24c Edition." +context: "Explizites Regelwerk für bidirektionale Notiz-Verbindungen. Definiert pro Source-Type typische und verbotene Edge-Typen (Canonical). Referenzen: types.yaml (gültige Note-Types) + edge_vocabulary.md (gültige Canonical Edge-Types & Inversen)." --- -# Graph Schema (Topologie & Symmetrie) +# Graph Schema (Topologie & Präferenzen) -**Logik:** Jede Sektion definiert exakt einen Quell-Notiztyp. Typical-Kanten werden in Obsidian priorisiert und im Backend als Standard-Beziehungen behandelt. +**Logik:** Jede Sektion definiert exakt einen **Quell-Notiztyp** (Source). +Für jeden Source werden pro **Target-Notiztyp** die bevorzugten (**Typical**) und unerwünschten (**Prohibited**) **Canonical Edge-Types** festgelegt. + +**Ziele:** +- konsistente Kantenwahl beim Schreiben (nicht „Nähe“, sondern „Beziehungstyp“) +- bessere Analyse-/Traversal-Signale (Roles/Policies bauen darauf auf) +- eindeutige Canonicals (Aliases werden im Mindnet-System normalisiert) --- -## 1. Identität & Kompetenz +## 1) Identität & Kompetenz ## Source: `person` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | +| `profile` | `consists_of` | `caused_by`, `solves` | +| `trait` | `consists_of` | `resulted_in` | | `skill` | `experienced_in`, `expert_for` | `caused_by`, `solves` | -| `role` | `part_of` | `blocks` | -| `trait` | `part_of` | `resulted_in` | -| `any` | `related_to` | - | +| `experience` | `related_to`, `references` | `caused_by` | +| `any` | `related_to`, `references` | - | -## Source: `skill` +## Source: `profile` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `person` | `mastered_by` | `consists_of` | -| `task` | `used_by` | `foundation_for` | -| `any` | `references`, `related_to` | - | - -## Source: `role` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `person` | `consists_of` | `caused_by` | -| `project` | `guides` | `solves` | +| `person` | `part_of` | `caused_by` | +| `value` | `guided_by`, `based_on` | `solves` | +| `principle` | `guided_by`, `based_on` | `solves` | +| `belief` | `guided_by`, `based_on` | `solves` | +| `any` | `related_to`, `references` | - | ## Source: `trait` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `any` | `related_to` | - | +| `person` | `part_of` | `resulted_in` | +| `experience` | `impacted_by`, `references` | `solves` | +| `any` | `related_to`, `references` | - | + +## Source: `skill` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `person` | `mastered_by`, `has_expert` | `consists_of` | +| `task` | `used_by` | `foundation_for` | +| `project` | `used_by` | `caused_by` | +| `any` | `references`, `related_to` | - | --- -## 2. Planung & Umsetzung (Action Stream) +## 2) Projekte, Aufgaben, Ziele ## Source: `project` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `task` | `consists_of` | `experienced_in` | -| `milestone` | `consists_of`, `followed_by` | `derived_from` | -| `goal` | `depends_on` | `similar_to` | -| `risk` | `impacted_by` | `part_of` | -| `any` | `references`, `depends_on` | - | +| `task` | `consists_of`, `depends_on` | `experienced_in` | +| `goal` | `guided_by`, `depends_on` | `similar_to` | +| `risk` | `has_risk`, `impacted_by` | `part_of` | +| `decision` | `derived_from`, `based_on` | `mastered_by` | +| `concept` | `based_on`, `references` | `followed_by` | +| `any` | `references`, `depends_on`, `related_to` | - | ## Source: `task` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | | `project` | `part_of` | `expert_for` | -| `task` | `followed_by`, `depends_on`, `preceeded_by` | `consists_of` | -| `milestone` | `followed_by`, `required_by` | `caused_by` | +| `task` | `followed_by`, `preceded_by`, `depends_on` | `consists_of` | +| `goal` | `required_by`, `foundation_for` | `similar_to` | | `skill` | `uses` | `mastered_by` | -| `any` | `depends_on`, `part_of` | - | - -## Source: `milestone` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `project` | `part_of` | `solves` | -| `task` | `preceeded_by`, `depends_on` | `expert_for` | +| `obstacle` | `blocked_by` | `consists_of` | +| `any` | `depends_on`, `part_of`, `references` | - | ## Source: `goal` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `any` | `depends_on`, `related_to` | - | +| `project` | `guides` | `solves` | +| `task` | `depends_on` | `similar_to` | +| `value` | `aligned_with`, `guided_by` | `violates` | +| `principle` | `aligned_with`, `guided_by` | `violates` | +| `any` | `depends_on`, `related_to`, `references` | - | ## Source: `habit` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `any` | `related_to`, `caused_by` | - | +| `task` | `foundation_for`, `depends_on` | `followed_by` | +| `goal` | `foundation_for` | `similar_to` | +| `value` | `guided_by`, `upholds` | `violates` | +| `principle` | `guided_by`, `upholds` | `violates` | +| `any` | `references`, `related_to` | - | --- -## 3. Erfahrung & Erkenntnis (History Stream) +## 3) Ereignisse, Erlebnisse, Journal + +## Source: `event` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `experience` | `resulted_in` | `solves` | +| `person` | `impacts`, `related_to` | `consists_of` | +| `state` | `resulted_in` | `solves` | +| `any` | `related_to`, `references` | - | ## Source: `experience` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `insight` | `resulted_in` | `depends_on` | -| `event` | `derived_from` | `solves` | -| `value` | `based_on` | `consists_of` | -| `person` | `caused_by` | `followed_by` | -| `any` | `derived_from`, `references` | - | - -## Source: `insight` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `experience` | `caused_by` | `uses` | -| `principle` | `resulted_in` | `consists_of` | -| `concept` | `based_on` | `followed_by` | -| `any` | `references`, `based_on` | - | - ---- - -## 4. Logik & Impact - -## Source: `decision` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `issue` | `solves` | `part_of` | -| `obstacle` | `solves` | `part_of` | -| `risk` | `impacts`, `solves` | `experienced_in` | -| `project` | `resulted_in`, `foundation_for` | `mastered_by` | -| `any` | `caused_by`, `references` | - | - -## Source: `issue` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `decision` | `solved_by`, `caused_by` | `consists_of` | -| `project` | `blocks` | `based_on` | -| `task` | `blocks` | `based_on` | - -## Source: `obstacle` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `decision` | `solved_by`, `caused_by` | `consists_of` | -| `project` | `blocks` | `based_on` | -| `task` | `blocks` | `based_on` | -| `any` | `blocks`, `related_to` | - | - -## Source: `risk` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `any` | `related_to`, `blocks` | - | - -## Source: `motivation` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `any` | `guides`, `references` | - | - -## Source: `bias` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `any` | `impacts`, `related_to` | - | - ---- - -## 5. Wissen & Basis - -## Source: `concept` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | +| `event` | `caused_by` | `consists_of` | +| `insight` | `resulted_in` | `solves` | +| `trait` | `impacts` | `consists_of` | +| `belief` | `impacts` | `consists_of` | +| `state` | `resulted_in`, `impacts` | `solves` | +| `person` | `related_to`, `references` | `consists_of` | | `any` | `references`, `related_to` | - | ## Source: `journal` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | +| `experience` | `source_of`, `references` | `solves` | +| `event` | `references` | `caused_by` | +| `state` | `references` | `caused_by` | +| `any` | `references`, `related_to` | - | + +--- + +## 4) Logik, Entscheidungen, Hindernisse, Risiken, Zustände + +## Source: `decision` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `obstacle` | `solves` | `part_of` | +| `risk` | `impacts`, `solves` | `experienced_in` | +| `project` | `resulted_in`, `foundation_for` | `mastered_by` | +| `habit` | `resulted_in`, `guides` | `mastered_by` | +| `insight` | `caused_by`, `based_on` | `consists_of` | +| `value` | `upholds`, `violates`, `aligned_with`, `conflicts_with` | `part_of` | +| `principle` | `upholds`, `violates`, `aligned_with`, `conflicts_with` | `part_of` | +| `any` | `caused_by`, `based_on`, `references` | - | + +## Source: `obstacle` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `task` | `blocks` | `consists_of` | +| `project` | `blocks` | `consists_of` | +| `decision` | `solved_by` | `consists_of` | +| `risk` | `impacts` | `part_of` | +| `any` | `related_to`, `references` | - | + +## Source: `risk` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `project` | `risk_of` | `consists_of` | +| `decision` | `impacts` | `consists_of` | +| `goal` | `risk_of`, `impacts` | `consists_of` | +| `any` | `references`, `related_to` | - | + +## Source: `state` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `experience` | `caused_by`, `impacted_by` | `solves` | +| `decision` | `impacts` | `consists_of` | +| `habit` | `impacts` | `consists_of` | +| `any` | `related_to`, `references` | - | + +--- + +## 5) Werte, Prinzipien, Überzeugungen, Grenzen, Bedürfnisse, Motivation, Bias + +## Source: `value` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `principle` | `foundation_for` | `violates` | +| `decision` | `guides`, `supports`, `contradicts` | `part_of` | +| `habit` | `guides` | `violates` | +| `profile` | `guides` | `violates` | +| `any` | `references`, `related_to` | - | + +## Source: `principle` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `value` | `based_on` | `violates` | +| `decision` | `guides`, `supports`, `contradicts` | `part_of` | +| `boundary` | `foundation_for`, `guides` | `violates` | +| `habit` | `guides` | `violates` | +| `any` | `references`, `related_to` | - | + +## Source: `belief` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `insight` | `supports`, `contradicts` | `consists_of` | +| `decision` | `guides`, `supports`, `contradicts` | `consists_of` | +| `value` | `aligned_with`, `conflicts_with` | `consists_of` | +| `principle` | `aligned_with`, `conflicts_with` | `consists_of` | +| `any` | `references`, `related_to` | - | + +## Source: `boundary` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `principle` | `based_on` | `violates` | +| `decision` | `blocks`, `guides` | `consists_of` | +| `task` | `blocks` | `consists_of` | +| `project` | `blocks` | `consists_of` | +| `any` | `references`, `related_to` | - | + +## Source: `need` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `motivation` | `resulted_in` | `consists_of` | +| `decision` | `impacts` | `consists_of` | +| `habit` | `impacts` | `consists_of` | +| `any` | `references`, `related_to` | - | + +## Source: `motivation` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `need` | `caused_by` | `consists_of` | +| `decision` | `guides`, `impacts` | `consists_of` | +| `habit` | `guides`, `impacts` | `consists_of` | +| `goal` | `guides` | `consists_of` | +| `any` | `references`, `related_to` | - | + +## Source: `bias` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `decision` | `impacts` | `consists_of` | +| `belief` | `contradicts`, `supports` | `consists_of` | +| `any` | `impacts`, `related_to`, `references` | - | + +--- + +## 6) Wissen, Ideen, Quellen, Glossar + +## Source: `concept` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `source` | `derived_from`, `references` | `followed_by` | +| `idea` | `foundation_for`, `supports` | `followed_by` | +| `glossary` | `part_of` | `caused_by` | +| `any` | `references`, `related_to` | - | + +## Source: `idea` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `concept` | `based_on`, `references` | `followed_by` | +| `project` | `foundation_for`, `resulted_in` | `mastered_by` | +| `decision` | `foundation_for`, `supports` | `consists_of` | +| `any` | `references`, `related_to` | - | + +## Source: `source` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `concept` | `source_of`, `references` | `caused_by` | +| `idea` | `source_of`, `references` | `caused_by` | +| `insight` | `source_of`, `references` | `caused_by` | | `any` | `references`, `related_to` | - | ## Source: `glossary` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `any` | `related_to` | - | - -## Source: `event` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `any` | `related_to` | - | - -## Source: `idea` -| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | -| :--- | :--- | :--- | -| `any` | `resulted_in`, `references` | - | +| `concept` | `consists_of` | `caused_by` | +| `any` | `references`, `related_to` | - | --- -## 6. Globaler Fallback +## 7) Insight (als Brücke zwischen Erfahrung und Entscheidung) + +## Source: `insight` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `experience` | `caused_by`, `references` | `consists_of` | +| `belief` | `resulted_in`, `supports`, `contradicts` | `consists_of` | +| `decision` | `foundation_for`, `guides` | `consists_of` | +| `habit` | `guides`, `foundation_for` | `consists_of` | +| `any` | `references`, `related_to` | - | + +--- + +## 8) Default / Global Fallback + +## Source: `default` +| Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | +| :--- | :--- | :--- | +| `any` | `related_to`, `references` | - | ## Source: `any` | Target-Note-type | Typical Edge-Types | Prohibited Edge-Types | | :--- | :--- | :--- | -| `any` | `related_to`, `references` | - | \ No newline at end of file +| `any` | `related_to`, `references` | - |