@chrisdudek/yg 5.0.3 → 5.1.0

package/dist/structure.d.ts

@@ -44,6 +44,12 @@ interface Ctx {
     node: GraphNode$1;
     /** alias for node.files (own node files with child carve-out) */
     files: File[];
+    /**
+     * the unit's subject file(s): per:file → single; per:node → the node's
+     * subject set (same array reference as `files` for the deterministic
+     * whole-node case).
+     */
+    subject: File[];
     fs: {
         exists(path: string): 'file' | 'dir' | false;
         list(dir: string): FsEntry[];
@@ -72,6 +78,12 @@ interface Violation {
 }
 /** check.mjs export signature (synchronous) */
 type CheckFunction = (ctx: Ctx) => Violation[];
+interface CompanionDescriptor {
+    path: string;
+    label?: string;
+}
+/** companion.mjs export — MAY be async (unlike sync-only check). Returns paths, never content. */
+type CompanionFunction = (ctx: Ctx) => CompanionDescriptor[] | Promise<CompanionDescriptor[]>;
 
 /**
  * Applicability filter. Evaluated by the CLI against the graph before an aspect
@@ -330,6 +342,12 @@ interface AspectDef {
      * Forbidden on aggregate aspects (no rule source to scope).
      */
     scope?: ScopeDef;
+    /**
+     * True when companion.mjs is present beside the aspect's rule sources.
+     * Valid only when reviewer.type === 'llm'. Set by the loader when companion.mjs
+     * is detected in the aspect directory.
+     */
+    hasCompanion?: boolean;
 }
 interface FlowDef {
     /** Directory name under flows/, e.g. "checkout-flow" */
@@ -344,10 +362,6 @@ interface FlowDef {
     /** Per-aspect explicit status override for aspects listed in `aspects` (channel 5) */
     aspectStatus?: Record<string, AspectStatus>;
 }
-interface SchemaDef {
-    /** Inferred from filename: 'node' | 'aspect' | 'flow' */
-    schemaType: string;
-}
 /**
  * Architecture file load error.
  *
@@ -391,7 +405,6 @@ interface Graph {
     nodes: Map<string, GraphNode>;
     aspects: AspectDef[];
     flows: FlowDef[];
-    schemas: SchemaDef[];
     /** Absolute path to the .yggdrasil/ directory */
     rootPath: string;
 }
@@ -402,6 +415,17 @@ type ParseCache = Map<string, {
     ast: Tree;
 }>;
 
+/**
+ * Raised by the shared hook loader and the deterministic structure runner.
+ * Defined here (not in runner.ts) so both the loader and the runner can throw it
+ * without a circular import; runner.ts re-exports it for backward compatibility.
+ */
+declare class StructureRunnerError extends Error {
+    readonly code: string;
+    readonly messageData: IssueMessage;
+    constructor(code: string, data: IssueMessage);
+}
+
 interface RunStructureAspectParams {
     aspectDir: string;
     aspectId: string;
@@ -434,11 +458,6 @@ interface RunStructureAspectResult {
      *  (file changed mid-run) — a tainted result must never be cached. */
     observationsTainted: boolean;
 }
-declare class StructureRunnerError extends Error {
-    readonly code: string;
-    readonly messageData: IssueMessage;
-    constructor(code: string, data: IssueMessage);
-}
 declare function runStructureAspect(params: RunStructureAspectParams): Promise<RunStructureAspectResult>;
 
-export { type CheckFunction, type Ctx, type File, type FsEntry, type GraphNode$1 as GraphNode, type Port, type Relation$1 as Relation, type RelationType$1 as RelationType, StructureRunnerError, type Violation, runStructureAspect };
+export { type CheckFunction, type CompanionDescriptor, type CompanionFunction, type Ctx, type File, type FsEntry, type GraphNode$1 as GraphNode, type Port, type Relation$1 as Relation, type RelationType$1 as RelationType, StructureRunnerError, type Violation, runStructureAspect };