@chrisdudek/yg 0.3.4 → 1.1.0

package/graph-schemas/config.yaml

@@ -0,0 +1,39 @@
+# config.yaml — Schema for the Yggdrasil project configuration
+# Located at .yggdrasil/config.yaml — one per project.
+# Edit this after running yg init to describe your project.
+
+name: "My Project"               # required — project display name
+
+stack:                            # required — technology stack (freeform keys)
+  language: "TypeScript"          #   primary language
+  runtime: "Node.js"             #   runtime environment
+  # framework: "Express"         #   optional — any additional stack entries
+  # database: "PostgreSQL"
+  # testing: "Vitest"
+
+standards: ""                     # optional — global coding conventions (free text)
+
+node_types:                       # required — allowed node type names
+  - name: module                  #   each type needs at least a 'name'
+    # required_aspects: []        #   optional — aspects every node of this type must have
+  - name: service
+  - name: library
+
+artifacts:                        # required — artifact type definitions
+  responsibility.md:              #   key = filename in node directories
+    required: always              #   always | never | { when: <condition> }
+    description: "What this node is responsible for, and what it is not"
+    structural_context: true      #   true = included in dependency context packages
+  interface.md:
+    required:
+      when: has_incoming_relations  # conditions: has_incoming_relations, has_outgoing_relations, has_aspect:<id>
+    description: "Public API — methods, parameters, return types, contracts"
+    structural_context: true
+  # Additional artifact types: logic.md, constraints.md, errors.md, model.md, state.md, decisions.md
+
+quality:                          # optional — quality thresholds
+  min_artifact_length: 50         #   minimum characters for an artifact (warning if below)
+  max_direct_relations: 10        #   maximum outgoing relations per node (warning if above)
+  context_budget:                 #   token budget for context packages
+    warning: 10000                #   tokens — warning threshold
+    error: 20000                  #   tokens — error threshold (suggests splitting)

package/graph-schemas/flow.yaml

@@ -0,0 +1,10 @@
+# flow.yaml — Schema for end-to-end business flows
+# Each flow is a directory under .yggdrasil/flows/ containing this file
+# plus description.md with required sections (see rules).
+
+name: EndToEndProcessName     # required — display name
+nodes:                        # required, non-empty — participant nodes
+  - orders/order-service      # paths relative to model/
+  - payments/payment-service
+  - inventory/inventory-service
+# aspects: [requires-saga]    # optional — aspect tags propagated to ALL participants

package/graph-schemas/node.yaml

@@ -0,0 +1,19 @@
+# node.yaml — Schema for model nodes
+# Every node is a directory under .yggdrasil/model/ containing this file
+# plus artifact .md files defined in config.yaml.
+
+name: ComponentName           # required — display name
+type: service                 # required — must match a type from config.node_types
+aspects: []                   # optional — list of aspect identifiers (directory paths under aspects/)
+blackbox: false               # optional, default false — if true, coarse-grained coverage without deep artifacts
+
+relations:                    # optional — outgoing dependencies to other nodes
+  - target: other/module-path # required — path relative to model/
+    type: calls               # required — calls | uses | extends | implements | emits | listens
+    consumes: [methodA, methodB] # optional — what is consumed from target
+    failure: 'retry 3x, then circuit-break' # optional — failure handling strategy
+    # event_name: OrderPlaced # optional — display name for event relations (emits, listens)
+
+mapping:                      # optional — link to source files for ownership and drift detection
+  paths:                      # required when mapping is present — list of file or directory paths
+    - src/modules/component/  # paths are relative to repository root

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrisdudek/yg",
-  "version": "0.3.4",
+  "version": "1.1.0",
   "description": "Make your repository self-aware. Persistent semantic memory and deterministic context assembly for AI agents.",
   "type": "module",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "files": [
     "dist/",
-    "graph-templates/"
+    "graph-schemas/"
   ],
   "engines": {
     "node": ">=22"

package/graph-templates/aspect.yaml

@@ -1,2 +0,0 @@
-name: CrossCuttingRequirementName
-tag: requires-tag-from-config

package/graph-templates/flow.yaml

@@ -1,8 +0,0 @@
-name: EndToEndProcessName
-nodes:
-  - orders/order-service
-  - payments/payment-service
-  - inventory/inventory-service
-knowledge:
-  - patterns/saga-pattern
-  - decisions/001-event-sourcing

package/graph-templates/knowledge.yaml

@@ -1,2 +0,0 @@
-name: ArchitecturalDecisionOrPatternName
-scope: global

package/graph-templates/node.yaml

@@ -1,17 +0,0 @@
-name: ComponentName
-type: service
-tags: []
-blackbox: false
-
-relations:
-  - target: other/module-path
-    type: calls
-    consumes: [methodA, methodB]
-    failure: 'retry 3x, then circuit-break'
-
-knowledge:
-  - decisions/001-choice-name
-
-mapping:
-  paths:
-    - src/modules/component/