@chrisdudek/yg 2.12.0 → 4.0.0

package/graph-schemas/yg-architecture.yaml

@@ -0,0 +1,12 @@
+# yg-architecture.yaml — Schema for architecture constraints
+# File: .yggdrasil/yg-architecture.yaml
+# Defines node types with architectural constraints.
+# All properties except description are optional — absence means no enforcement.
+
+node_types:
+  <type-id>:
+    description: <string>                    # required — what this type is for
+    aspects: [<aspect-id>]                   # optional — required on every file of this type
+    parents: [<type-id>]                     # optional — allowed parent types
+    relations:                               # optional — allowed relation targets
+      <relation-type>: [<type-id>]           # calls | uses | extends | implements | emits | listens

package/graph-schemas/yg-aspect.yaml

@@ -7,7 +7,3 @@
 name: CrossCuttingRequirementName  # required — display name
 description: "Short description for discovery via yg aspects"  # optional
 # implies: [other-aspect, another-aspect] # optional — other aspect identifiers included automatically (recursive, must be acyclic)
-# stability: protocol        # optional — schema | protocol | implementation
-                              # schema = enforced by data model (most stable)
-                              # protocol = enforced by convention/contract
-                              # implementation = specific mechanism (least stable, review after any code change)

package/graph-schemas/yg-config.yaml

@@ -2,36 +2,26 @@
 # Located at .yggdrasil/yg-config.yaml — one per project.
 # Edit this after running yg init to describe your project.
 
-version: "2.0.0"                  # managed by CLI — do not edit manually. Tracks the CLI version
-                                  # that created or last migrated this config. Used by the migration
-                                  # system to determine which migrations to run on upgrade.
+version: "4.0.0"                  # managed by CLI — do not edit manually. Tracks the CLI version
+                                  # that last initialized or upgraded this config.
 
-name: "My Project"               # required — project display name
+quality:                          # optional — quality thresholds
+  max_direct_relations: 10        #   maximum outgoing relations per node (warning if above)
+  max_mapping_source_files: 10    #   maximum source files per node (warning if above, for nodes with aspects)
 
-node_types:                       # required — non-empty object of node type definitions
-  module:                         #   key = type name used in yg-node.yaml
-    description: "Business logic unit with clear domain responsibility"
-    # required_aspects: []        #   optional — aspects every node of this type must have
-  service:
-    description: "Component providing functionality to other nodes"
-  library:
-    description: "Shared utility code with no domain knowledge"
+parallel: 1                       # optional — concurrency limit for batch approve (positive integer, default: 1)
 
-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"
-    included_in_relations: 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"
-    included_in_relations: true
-  # Additional artifact types: logic.md, constraints.md, errors.md, model.md, state.md, decisions.md
+debug: false                      # optional — when true, appends all command output to .yggdrasil/.debug.log
+                                  # Default: false (off). Log is append-only; rotate or delete manually.
 
-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)
+reviewer:                         # required — aspect verification during yg approve
+  active: ollama                  #   required when multiple providers configured
+  consensus: 1                    #   positive odd integer >= 1 (3+ for majority vote)
+  ollama:                         #   provider-specific config
+    model: "qwen3.5:9b"          #     model ID
+    endpoint: "http://localhost:11434"  #   custom endpoint
+    temperature: 0                #     reduces variability — keep at 0
+    max_tokens: auto              #     auto = query provider, or explicit number
+    context_length_field: ""      #     ollama model_info key for context window size
+  claude-code:                    #   alternative provider — uses claude CLI subprocess
+    model: haiku                  #     haiku, sonnet, or opus

package/graph-schemas/yg-flow.yaml

@@ -1,6 +1,5 @@
 # yg-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).
+# Each flow is a directory under .yggdrasil/flows/ containing this file.
 
 name: EndToEndProcessName     # required — display name
 description: "Short description of this business process"  # optional

package/graph-schemas/yg-node.yaml

@@ -1,27 +1,23 @@
 # yg-node.yaml — Schema for model nodes
-# Every node is a directory under .yggdrasil/model/ containing this file
-# plus artifact .md files defined in yg-config.yaml.
+# Every node is a directory under .yggdrasil/model/ containing this file.
 
 name: ComponentName           # required — display name
-type: service                 # required — must match a type from config.node_types
+type: service                 # required — must match a type from yg-architecture.yaml
 description: "Short description of what this node does"  # optional
-blackbox: false               # optional, default false — if true, coarse-grained coverage without deep artifacts
 
-aspects:                      # optional — list of aspect configurations
-  - aspect: aspect-id         # required — aspect identifier (directory path under aspects/)
-    exceptions:               # optional — how this node deviates from the aspect's pattern
-      - "Description of deviation and why"
-    anchors:                  # optional — code patterns for aspect staleness detection
-      - functionName          # yg validate checks each pattern exists in mapped source files (W014)
-      - CONSTANT_NAME
+aspects:                      # optional — list of aspect identifiers
+  - aspect-id                 # aspect directory name under aspects/
+
+ports:                        # optional — named entry points with required aspects (on target nodes)
+  port-name:
+    description: "What this port provides"  # required
+    aspects: [aspect-id]      # required — aspects consumers must satisfy
 
 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)
+    consumes: [port-name]     # optional — port names consumed from target (required when target has ports)
 
-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
+mapping:                      # optional — flat list of source file or directory paths
+  - src/modules/component/    # paths are relative to repository root
+  - src/modules/component.ts

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@chrisdudek/yg",
-  "version": "2.12.0",
-  "description": "Make your repository self-aware. Persistent semantic memory and deterministic context assembly for AI agents.",
+  "version": "4.0.0",
+  "description": "Continuous architecture enforcement for AI-assisted development. Aspects, review, enforcement.",
   "type": "module",
   "bin": {
     "yg": "dist/bin.js"
   },
   "files": [
-    "dist/",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
     "graph-schemas/"
   ],
   "engines": {
@@ -18,6 +19,7 @@
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:external": "vitest run --config vitest.external.config.ts",
     "test:coverage": "vitest run --coverage",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
@@ -26,13 +28,13 @@
   },
   "keywords": [
     "yggdrasil",
-    "graph",
-    "ai",
-    "specification",
-    "architecture",
+    "ai-agents",
+    "architecture-enforcement",
+    "code-review",
+    "ai-governance",
     "cli",
-    "agent-commands",
-    "code-generation"
+    "developer-tools",
+    "ai-coding"
   ],
   "author": "Krzysztof Dudek <me@chrisdudek.com>",
   "license": "MIT",
@@ -50,6 +52,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@clack/prompts": "^1.2.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "ignore": "^7.0.5",
@@ -64,7 +67,7 @@
     "eslint": "^10.0.1",
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "typescript-eslint": "^8.56.0",
     "vitest": "^4.0.18"
   }