@chrisdudek/yg 5.0.0-alpha.3 → 5.0.0-alpha.5

package/graph-schemas/yg-architecture.yaml

@@ -10,7 +10,7 @@
 node_types:
   <type-id>:
     description: <string>                    # required — what this type is for, when to use it.
-                                             # Validator emits description-missing if absent.
+                                             # absence is a FATAL architecture-invalid error (the whole type system is rejected).
 
     when: <file-predicate>                   # optional — per-file classification.
                                              # Types WITH `when` are file-classifying: every file in
@@ -38,9 +38,14 @@ node_types:
                                              # Use only for types where missing the type means missing
                                              # a critical aspect (security, audit, regulatory).
 
-    log_required: <boolean>                  # optional — default true. Set false for infrastructure
-                                             # or utility types where an approval log adds no value
-                                             # (e.g. config, types, constants).
+    log_required: <boolean>                  # optional — default false. Enable (true) on types whose
+                                             # changes carry business intent worth capturing — domain
+                                             # logic, command handlers, persistence adapters. When true,
+                                             # a node of this type demands a fresh log entry before
+                                             # `yg check --approve` whenever its mapped source changed
+                                             # since the node's last positive closure. Leave omitted
+                                             # (false) for types whose changes carry no business decision
+                                             # worth forcing an entry for (e.g. config, types, constants).
 
     aspects:                                 # optional — aspects automatically applied to every
                                              # node of this type (channel 3). Two forms per entry:

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,7 +7,6 @@ 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)
 
@@ -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.
@@ -35,9 +34,12 @@ reviewer:                         # required — aspect verification during yg a
         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

@@ -43,9 +43,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.3",
+  "version": "5.0.0-alpha.5",
   "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": {