@chrisdudek/yg 5.0.0-alpha.4 → 5.0.0-alpha.6

package/graph-schemas/yg-aspect.yaml

@@ -116,6 +116,60 @@ status: enforced                   # optional — aspect-level default. enum: dr
                                    #       - relations: { calls: { target_type: service-client } }
                                    #       - descendants: { relations: { calls: { target_type: service-client } } }
 
+# scope:                            # optional — controls review granularity (applies to both LLM
+                                   # and deterministic aspects). Forbidden on aggregate aspects.
+                                   # Absent → equivalent to { per: node }.
+                                   #
+                                   # Fields:
+                                   #   per: node | file     REQUIRED. Default: node.
+                                   #     node — one review over the whole subject set.
+                                   #            LLM: one prompt with all subject files.
+                                   #            Deterministic: one check(ctx) invocation; ctx.files = subject set.
+                                   #     file — one review per subject file.
+                                   #            LLM: one prompt per file.
+                                   #            Deterministic: one check(ctx) invocation per file; ctx.files = [file].
+                                   #            WARNING: per: file is ONLY for file-local rules — a per-file
+                                   #            reviewer cannot see sibling files. Rules that need cross-file
+                                   #            context (e.g. "correlation ID propagates across calls") must
+                                   #            stay per: node. Before switching an aspect to per: file, verify
+                                   #            the rule can be judged from that single file alone.
+                                   #
+                                   #   files: <file-predicate>   OPTIONAL. Filters which mapped files enter
+                                   #     the subject set. Subject set = mapped files ∩ filter.
+                                   #     Absent → all mapped files.
+                                   #     Empty subject set after filtering → vacuous pass by design (no review,
+                                   #     no error). An aspect may legitimately exclude every file of a node it
+                                   #     lands on (e.g. a filter that matches only *.ts files landing on a
+                                   #     node with only *.py files).
+                                   #
+                                   #     File-predicate grammar — atoms:
+                                   #       path: "glob"        minimatch glob on repo-relative POSIX path
+                                   #       content: "regex"    JavaScript regex tested against file content
+                                   #     Boolean combinators (same as aspect when:):
+                                   #       all_of: [...]       AND
+                                   #       any_of: [...]       OR
+                                   #       not: <clause>       negation
+                                   #     Top-level path + content imply all_of.
+                                   #
+                                   #     NOTE: path/content are FILE atoms — they belong here in scope.files.
+                                   #     The aspect-level when: field uses NODE atoms (node, relations,
+                                   #     descendants) and filters which NODES the aspect applies to — do not
+                                   #     mix the two. The CLI will cross-hint you if you use an atom in the
+                                   #     wrong site.
+                                   #
+                                   # Cost note: editing scope: (per or files) changes the input hash for
+                                   # every pair of this aspect — every node using the aspect needs
+                                   # re-verification. Run `yg impact --aspect <id>` before widening or
+                                   # narrowing the filter.
+                                   #
+                                   # Example:
+                                   #   scope:
+                                   #     per: file
+                                   #     files:
+                                   #       all_of:
+                                   #         - path: "src/**/*.ts"
+                                   #         - not: { path: "**/*.test.ts" }
+
 # references:                      # optional — supporting files for the LLM reviewer.
                                    #   Permitted on LLM aspects ONLY (forbidden on deterministic).
                                    #   Each entry is a string (shorthand) OR an object { path, description? }.

package/graph-schemas/yg-config.yaml

@@ -7,9 +7,8 @@ version: "5.0.0"                  # managed by CLI — do not edit manually. Tra
 
 quality:                          # optional — quality thresholds
   max_direct_relations: 10        #   maximum outgoing relations per node (warning if above)
-  max_node_chars: 40000           #   per-node character budget — mapped source + aspect reference files (error if above; binaries skipped; opt out per-node via sizeExempt)
 
-parallel: 1                       # optional — concurrency limit for batch approve (positive integer, default: 1)
+parallel: 1                       # optional — concurrency limit for the yg check --approve fill (positive integer, default: 1)
 
 debug: false                      # optional — when true, appends all command output to .yggdrasil/.debug.log
                                   # Default: false (off). Log is append-only; rotate or delete manually.
@@ -20,7 +19,7 @@ coverage:                         # optional — scopes the unmapped-files gate.
                                   # Files outside required and excluded are a non-blocking WARNING.
                                   # Subtrees containing their own nested .yggdrasil/ are auto-skipped by every check.
 
-reviewer:                         # required — aspect verification during yg approve
+reviewer:                         # required — aspect verification during yg check --approve
   default: standard               # required when more than one tier is configured; optional with exactly one tier.
                                   #   Must reference one of the keys under reviewer.tiers.
   tiers:                          # required — named tier configurations, minimum one entry.
@@ -32,12 +31,13 @@ reviewer:                         # required — aspect verification during yg a
         model: "qwen3.5:9b"       #       model id
         endpoint: "http://localhost:11434"   # custom endpoint (required for ollama, openai-compatible)
         temperature: 0            #       reduces variability — keep at 0
-        max_tokens: auto          #       auto = query provider, or explicit positive integer
-        context_length_field: ""  #       ollama: model_info key for context window size
         # timeout: 300            #       Per-call timeout in SECONDS (default 300). Only CLI providers.
-      # references:                # optional — limits on aspect reference files for aspects resolving to this tier
-      #   max_bytes_per_file: 65536          # positive integer; default 65536 (64 KiB)
-      #   max_total_bytes_per_aspect: 262144 # positive integer; default 262144 (256 KiB)
+      # max_prompt_chars: 200000  # optional — assembled reviewer-prompt character cap (positive integer).
+                                  #   Checked deterministically before the LLM call. Absent = unlimited.
+                                  #   Exceeding this limit renders a blocking error naming remedies
+                                  #   (split the node, shorten references, or raise the cap).
+                                  #   Never participates in verdict identity — tuning it does not
+                                  #   invalidate recorded baselines.
     # Add more tiers as needed (e.g. a `deep` tier with a higher-capability model for critical aspects).
     # An aspect references a non-default tier via:
     #

package/graph-schemas/yg-node.yaml

@@ -29,6 +29,11 @@ ports:                        # optional — named entry points with required as
         when: <predicate>     #   optional — object form with per-attach applicability filter
 
 relations:                    # optional — outgoing dependencies to other nodes
+                              # Load-bearing, not just documentation: a built-in deterministic check
+                              # parses this node's mapped code and REFUSES it (relation-undeclared-dependency,
+                              # always an error) if it depends on another mapped node without a relation here.
+                              # One-directional — a declared relation needs no code behind it. See
+                              # `yg knowledge read ports-and-relations`.
   - target: other/module-path # required — node path relative to model/
     type: calls               # required — calls | uses | extends | implements | emits | listens
     consumes: [port-name]     # optional — port names consumed from target
@@ -43,9 +48,3 @@ mapping:                      # optional — source files and directories owned
                               # paths are relative to repository root
                               # each source file must have exactly one owner node
 
-sizeExempt:                   # optional — opt out of the per-node character budget (quality.max_node_chars)
-  reason: "package-lock.json is npm-generated and cannot be split"  # required — non-empty justification
-                              # Binary files (images, fonts, archives, etc.) count 0 toward the budget
-                              # automatically — they never need sizeExempt. Use sizeExempt ONLY for a
-                              # large unsplittable TEXT artifact (e.g. a generated lockfile), not images.
-                              # Normal oversized nodes must be split.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrisdudek/yg",
-  "version": "5.0.0-alpha.4",
+  "version": "5.0.0-alpha.6",
   "description": "Architecture rules your coding agent can't ignore. Written in Markdown, verified on every change, enforced in the agent's loop — not after on a PR. Works with Claude Code, Cursor, Copilot, Codex, Cline.",
   "type": "module",
   "bin": {
@@ -107,5 +107,8 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.0",
     "vitest": "^4.1.8"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1"
   }
 }