laymos 0.0.6 → 0.0.8

package/dist/architecture-analysis-schema/architecture-analysis-schema.d.ts

@@ -8,9 +8,11 @@ export declare const ArchitectureAnalysisSchema: Schema.Struct<{
         readonly sourceRoots: Schema.$Array<Schema.String>;
         readonly ignoredPaths: Schema.$Array<Schema.String>;
         readonly storiesPath: Schema.optional<Schema.String>;
+        readonly storyTimeout: Schema.optional<Schema.String>;
         readonly layers: Schema.$Record<Schema.String, Schema.Struct<{
             readonly paths: Schema.$Array<Schema.String>;
             readonly description: Schema.optional<Schema.String>;
+            readonly docsPath: Schema.optional<Schema.String>;
             readonly modules: Schema.$Record<Schema.String, Schema.Struct<{
                 readonly shared: Schema.Boolean;
                 readonly exposed: Schema.Boolean;
@@ -18,6 +20,7 @@ export declare const ArchitectureAnalysisSchema: Schema.Struct<{
             readonly moduleGraphs: Schema.$Record<Schema.String, Schema.Struct<{
                 readonly description: Schema.optional<Schema.String>;
                 readonly path: Schema.String;
+                readonly docsPath: Schema.optional<Schema.String>;
                 readonly modules: Schema.$Record<Schema.String, Schema.Struct<{
                     readonly shared: Schema.Boolean;
                     readonly exposed: Schema.Boolean;
@@ -27,6 +30,7 @@ export declare const ArchitectureAnalysisSchema: Schema.Struct<{
         }>>;
         readonly layerGraphs: Schema.$Record<Schema.String, Schema.Struct<{
             readonly description: Schema.optional<Schema.String>;
+            readonly docsPath: Schema.optional<Schema.String>;
             readonly rules: Schema.$Record<Schema.String, Schema.$Array<Schema.String>>;
         }>>;
     }>;

package/dist/architecture-analysis-schema/architecture-analysis-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architecture-analysis-schema.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/architecture-analysis-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,GACpB,CAAC;AACF,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,CAAC"}
+{"version":3,"file":"architecture-analysis-schema.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/architecture-analysis-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,GACpB,CAAC;AACF,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,CAAC"}

package/dist/architecture-analysis-schema/documentation-schema.d.ts

@@ -0,0 +1,36 @@
+import { Schema } from 'effect';
+export declare const DocumentationScopeSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"module">;
+    readonly modulePath: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"module-graph">;
+    readonly layerId: Schema.String;
+    readonly graphId: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"layer">;
+    readonly layerId: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"layer-graph">;
+    readonly graphId: Schema.String;
+}>]>;
+export type DocumentationScope = typeof DocumentationScopeSchema.Type;
+export declare const DocumentationSchema: Schema.Struct<{
+    readonly scope: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"module">;
+        readonly modulePath: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"module-graph">;
+        readonly layerId: Schema.String;
+        readonly graphId: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"layer">;
+        readonly layerId: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"layer-graph">;
+        readonly graphId: Schema.String;
+    }>]>;
+    readonly path: Schema.optional<Schema.String>;
+    readonly content: Schema.optional<Schema.String>;
+}>;
+export type Documentation = typeof DocumentationSchema.Type;
+//# sourceMappingURL=documentation-schema.d.ts.map

package/dist/architecture-analysis-schema/documentation-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-schema.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/documentation-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;IAYnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC;AAEtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;EAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC"}

package/dist/architecture-analysis-schema/documentation-schema.js

@@ -0,0 +1,19 @@
+import { Schema } from 'effect';
+export const DocumentationScopeSchema = Schema.Union([
+    Schema.Struct({ kind: Schema.Literal('module'), modulePath: Schema.String }),
+    Schema.Struct({
+        kind: Schema.Literal('module-graph'),
+        layerId: Schema.String,
+        graphId: Schema.String,
+    }),
+    Schema.Struct({ kind: Schema.Literal('layer'), layerId: Schema.String }),
+    Schema.Struct({
+        kind: Schema.Literal('layer-graph'),
+        graphId: Schema.String,
+    }),
+]);
+export const DocumentationSchema = Schema.Struct({
+    scope: DocumentationScopeSchema,
+    path: Schema.optional(Schema.String),
+    content: Schema.optional(Schema.String),
+});

package/dist/architecture-analysis-schema/index.d.ts

@@ -4,4 +4,6 @@ export { ArchitectureAnalysisSchema, ConfigValidationIssueSchema, LayerAnalysisS
 export type { AnalyzedModule, AnalyzedModuleGraph, ArchitectureAnalysis, Config, ConfigValidationIssue, ForbiddenImport, LayerAnalysis, LayerDefinition, ModuleAnalysis, ModuleConfig, ModuleDefinition, ModuleDependency, ModuleGraphConfig, ModuleGraphDefinition, ModuleShape, ModuleViolation, ObservedModuleKind, } from './architecture-analysis-schema.js';
 export { ModuleSourceFileSchema, ModuleSourceSnapshotSchema, } from './module-source-schema.js';
 export type { ModuleSourceFile, ModuleSourceSnapshot, } from './module-source-schema.js';
+export { DocumentationScopeSchema, DocumentationSchema, } from './documentation-schema.js';
+export type { Documentation, DocumentationScope, } from './documentation-schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/architecture-analysis-schema/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,oEAAoE;AACpE,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,oEAAoE;AACpE,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC"}

package/dist/architecture-analysis-schema/index.js

@@ -1,3 +1,4 @@
 /** Browser and RPC consumers use this canonical Architecture Analysis contract. */
 export { ArchitectureAnalysisSchema, ConfigValidationIssueSchema, LayerAnalysisSchema, ModuleAnalysisSchema, ProjectConfigInputSchema, ProjectConfigSchema, } from './architecture-analysis-schema.js';
 export { ModuleSourceFileSchema, ModuleSourceSnapshotSchema, } from './module-source-schema.js';
+export { DocumentationScopeSchema, DocumentationSchema, } from './documentation-schema.js';

package/dist/architecture-analysis-schema/project-config-schema.d.ts

@@ -6,6 +6,7 @@ declare const ModuleSchema: Schema.Struct<{
 declare const ModuleGraphSchema: Schema.Struct<{
     readonly description: Schema.optional<Schema.String>;
     readonly path: Schema.String;
+    readonly docsPath: Schema.optional<Schema.String>;
     readonly modules: Schema.$Record<Schema.String, Schema.Struct<{
         readonly shared: Schema.Boolean;
         readonly exposed: Schema.Boolean;
@@ -22,9 +23,11 @@ export declare const ProjectConfigSchema: Schema.Struct<{
     readonly sourceRoots: Schema.$Array<Schema.String>;
     readonly ignoredPaths: Schema.$Array<Schema.String>;
     readonly storiesPath: Schema.optional<Schema.String>;
+    readonly storyTimeout: Schema.optional<Schema.String>;
     readonly layers: Schema.$Record<Schema.String, Schema.Struct<{
         readonly paths: Schema.$Array<Schema.String>;
         readonly description: Schema.optional<Schema.String>;
+        readonly docsPath: Schema.optional<Schema.String>;
         readonly modules: Schema.$Record<Schema.String, Schema.Struct<{
             readonly shared: Schema.Boolean;
             readonly exposed: Schema.Boolean;
@@ -32,6 +35,7 @@ export declare const ProjectConfigSchema: Schema.Struct<{
         readonly moduleGraphs: Schema.$Record<Schema.String, Schema.Struct<{
             readonly description: Schema.optional<Schema.String>;
             readonly path: Schema.String;
+            readonly docsPath: Schema.optional<Schema.String>;
             readonly modules: Schema.$Record<Schema.String, Schema.Struct<{
                 readonly shared: Schema.Boolean;
                 readonly exposed: Schema.Boolean;
@@ -41,6 +45,7 @@ export declare const ProjectConfigSchema: Schema.Struct<{
     }>>;
     readonly layerGraphs: Schema.$Record<Schema.String, Schema.Struct<{
         readonly description: Schema.optional<Schema.String>;
+        readonly docsPath: Schema.optional<Schema.String>;
         readonly rules: Schema.$Record<Schema.String, Schema.$Array<Schema.String>>;
     }>>;
 }>;
@@ -54,9 +59,11 @@ export declare const ProjectConfigInputSchema: Schema.Struct<{
     readonly sourceRoots: Schema.$Array<Schema.String>;
     readonly ignoredPaths: Schema.withDecodingDefaultKey<Schema.$Array<Schema.String>, never>;
     readonly storiesPath: Schema.optional<Schema.String>;
+    readonly storyTimeout: Schema.optional<Schema.String>;
     readonly layers: Schema.$Record<Schema.String, Schema.Struct<{
         readonly paths: Schema.$Array<Schema.String>;
         readonly description: Schema.optional<Schema.String>;
+        readonly docsPath: Schema.optional<Schema.String>;
         readonly modules: Schema.withDecodingDefaultKey<Schema.$Record<Schema.String, Schema.Struct<{
             readonly shared: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
             readonly exposed: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
@@ -64,6 +71,7 @@ export declare const ProjectConfigInputSchema: Schema.Struct<{
         readonly moduleGraphs: Schema.withDecodingDefaultKey<Schema.$Record<Schema.String, Schema.Struct<{
             readonly description: Schema.optional<Schema.String>;
             readonly path: Schema.String;
+            readonly docsPath: Schema.optional<Schema.String>;
             readonly modules: Schema.$Record<Schema.String, Schema.Struct<{
                 readonly shared: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
                 readonly exposed: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
@@ -73,6 +81,7 @@ export declare const ProjectConfigInputSchema: Schema.Struct<{
     }>>;
     readonly layerGraphs: Schema.$Record<Schema.String, Schema.Struct<{
         readonly description: Schema.optional<Schema.String>;
+        readonly docsPath: Schema.optional<Schema.String>;
         readonly rules: Schema.$Record<Schema.String, Schema.$Array<Schema.String>>;
     }>>;
 }>;

package/dist/architecture-analysis-schema/project-config-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-config-schema.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/project-config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAiBxC,QAAA,MAAM,YAAY;;;EAGY,CAAC;AAqC/B,QAAA,MAAM,iBAAiB;;;;;;;;EAOY,CAAC;AA2HpC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;EASK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;EAWA,CAAC;AAEtC,MAAM,MAAM,MAAM,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAE9D,eAAO,MAAM,2BAA2B;;;EAatC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAC"}
+{"version":3,"file":"project-config-schema.d.ts","sourceRoot":"","sources":["../../src/architecture-analysis-schema/project-config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAiBxC,QAAA,MAAM,YAAY;;;EAGY,CAAC;AA0C/B,QAAA,MAAM,iBAAiB;;;;;;;;;EAQY,CAAC;AAoIpC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYA,CAAC;AAEtC,MAAM,MAAM,MAAM,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAE9D,eAAO,MAAM,2BAA2B;;;EAatC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAC"}

package/dist/architecture-analysis-schema/project-config-schema.js

@@ -27,12 +27,16 @@ const graphDescriptionField = Schema.optional(Schema.String).annotate({
 const graphPathField = Schema.String.annotate({
     description: 'Canonical project-relative directory rooting this Module Graph. Every member lives below it and every file below it must belong to a member.',
 });
+const docsPathField = Schema.optional(Schema.String).annotate({
+    description: 'Canonical project-relative path to a markdown file documenting this entity. Read-only: Laymos never writes to it.',
+});
 const graphModulesDescription = 'Every member of this Module Graph, keyed relative to its path. At least two members, at least one exposed, and no member may be Shared.';
 const graphRulesDescription = 'Maps a member key to the member keys it may directly depend on. Rules are default-deny and, unlike LayerGraph Rules, are NOT transitive: only declared edges are permitted. They must be acyclic within this Module Graph.';
 const GraphRulesSchema = Schema.Record(Schema.String, Schema.Array(Schema.String)).annotate({ description: graphRulesDescription });
 const ModuleGraphSchema = Schema.Struct({
     description: graphDescriptionField,
     path: graphPathField,
+    docsPath: docsPathField,
     modules: Schema.Record(Schema.String, ModuleSchema)
         .annotate({ description: graphModulesDescription })
         .pipe(Schema.check(Schema.isMinProperties(2))),
@@ -41,6 +45,7 @@ const ModuleGraphSchema = Schema.Struct({
 const ModuleGraphInputSchema = Schema.Struct({
     description: graphDescriptionField,
     path: graphPathField,
+    docsPath: docsPathField,
     modules: Schema.Record(Schema.String, ModuleInputSchema)
         .annotate({ description: graphModulesDescription })
         .pipe(Schema.check(Schema.isMinProperties(2))),
@@ -63,6 +68,7 @@ const layerModuleGraphsDescription = 'Every Module Graph in this Layer, keyed by
 const LayerSchema = Schema.Struct({
     paths: layerPathsField,
     description: layerDescriptionField,
+    docsPath: docsPathField,
     modules: Schema.Record(Schema.String, ModuleSchema).annotate({
         description: layerModulesDescription,
     }),
@@ -73,6 +79,7 @@ const LayerSchema = Schema.Struct({
 const LayerInputSchema = Schema.Struct({
     paths: layerPathsField,
     description: layerDescriptionField,
+    docsPath: docsPathField,
     modules: Schema.Record(Schema.String, ModuleInputSchema)
         .annotate({ description: layerModulesDescription })
         .pipe(Schema.withDecodingDefaultKey(Effect.succeed({}))),
@@ -84,6 +91,7 @@ const LayerGraphSchema = Schema.Struct({
     description: Schema.optional(Schema.String).annotate({
         description: 'Human-readable summary of this LayerGraph.',
     }),
+    docsPath: docsPathField,
     rules: Schema.Record(Schema.String, Schema.Array(Schema.String)).annotate({
         description: 'Maps a Layer id to the Layer ids it may directly depend on. Rules are default-deny and transitive: a dependency between two Layers with no declared path between them, direct or transitive, is a violation. A Layer with no outgoing rule is a valid, intentional leaf.',
     }),
@@ -109,6 +117,9 @@ const IgnoredPathsSchema = Schema.Array(Schema.String).annotate({
 const storiesPathField = Schema.optional(Schema.String).annotate({
     description: 'Canonical project-relative folder holding every Story file and the index.ts entry point exposing the Story Collection. Implicitly an Ignored path.',
 });
+const storyTimeoutField = Schema.optional(Schema.String).annotate({
+    description: 'How long one Story may run before it is failed as timed out, as an Effect Duration string (e.g. "10 seconds"). Defaults to 10 seconds; a Story may override it with its own timeout.',
+});
 const layersDescription = 'Every Layer in the project, keyed by id, each owning its Modules and Module Graphs.';
 const layerGraphsField = Schema.Record(Schema.String, LayerGraphSchema).annotate({
     description: 'Every LayerGraph in the project, keyed by id. An empty set denies every cross-Layer dependency.',
@@ -123,6 +134,7 @@ export const ProjectConfigSchema = Schema.Struct({
     sourceRoots: sourceRootsField,
     ignoredPaths: IgnoredPathsSchema,
     storiesPath: storiesPathField,
+    storyTimeout: storyTimeoutField,
     layers: Schema.Record(Schema.String, LayerSchema)
         .annotate({ description: layersDescription })
         .pipe(Schema.check(Schema.isMinProperties(1))),
@@ -138,6 +150,7 @@ export const ProjectConfigInputSchema = Schema.Struct({
     sourceRoots: sourceRootsField,
     ignoredPaths: IgnoredPathsSchema.pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
     storiesPath: storiesPathField,
+    storyTimeout: storyTimeoutField,
     layers: Schema.Record(Schema.String, LayerInputSchema)
         .annotate({ description: layersDescription })
         .pipe(Schema.check(Schema.isMinProperties(1))),

package/dist/change-set-schema/change-set-schema.d.ts

@@ -52,4 +52,10 @@ export declare const FileDiffSchema: Schema.Struct<{
     }>>;
 }>;
 export type FileDiff = typeof FileDiffSchema.Type;
+export declare const BranchSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly remote: Schema.Boolean;
+    readonly current: Schema.Boolean;
+}>;
+export type Branch = typeof BranchSchema.Type;
 //# sourceMappingURL=change-set-schema.d.ts.map

package/dist/change-set-schema/change-set-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-set-schema.d.ts","sourceRoot":"","sources":["../../src/change-set-schema/change-set-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,kBAAkB,iDAAyC,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;EAS5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;EAO1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;;EASzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;EAQzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC"}
+{"version":3,"file":"change-set-schema.d.ts","sourceRoot":"","sources":["../../src/change-set-schema/change-set-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,kBAAkB,iDAAyC,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;EAS5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;EAO1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;;EASzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;EAQzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,YAAY;;;;EAQvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC"}

package/dist/change-set-schema/change-set-schema.js

@@ -41,3 +41,11 @@ export const FileDiffSchema = Schema.Struct({
     title: 'File Diff',
     description: 'The changed regions of one modified path between a Base ref and the working tree, parsed into hunks and numbered lines.',
 });
+export const BranchSchema = Schema.Struct({
+    name: Schema.String,
+    remote: Schema.Boolean,
+    current: Schema.Boolean,
+}).annotate({
+    title: 'Branch',
+    description: "One local or remote-tracking branch a Change set's Base ref may name. `current` marks the branch HEAD is on.",
+});

package/dist/change-set-schema/index.d.ts

@@ -1,3 +1,3 @@
-export { ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema.js';
-export type { ChangedPath, ChangeSet, ChangeStatus, DiffHunk, DiffLine, FileDiff, } from './change-set-schema.js';
+export { BranchSchema, ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema.js';
+export type { Branch, ChangedPath, ChangeSet, ChangeStatus, DiffHunk, DiffLine, FileDiff, } from './change-set-schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/change-set-schema/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/change-set-schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/change-set-schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,MAAM,EACN,WAAW,EACX,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,wBAAwB,CAAC"}

package/dist/change-set-schema/index.js

@@ -1,2 +1,2 @@
 // RPC transports use this browser-safe runtime contract for Change sets.
-export { ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema.js';
+export { BranchSchema, ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema.js';

package/dist/cli/lint/lint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../src/cli/lint/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQ9C,wBAAgB,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,+QAW5C"}
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../src/cli/lint/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAa9C,wBAAgB,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,+QAW5C"}

package/dist/cli/lint/lint.js

@@ -1,10 +1,12 @@
 import { Console, Effect } from 'effect';
 import { Command } from 'effect/unstable/cli';
 import { analyzeProject } from '../../orchestrator/analyze-project/index.js';
+import { getStoryTree } from '../../orchestrator/run-stories/index.js';
 import { makeLayersCommand } from './layers/index.js';
 import { renderLayerReport } from './layers/report.js';
 import { makeModulesCommand } from './modules/index.js';
 import { renderModuleReport } from './modules/report.js';
+import { countGroupsWithoutPage, renderStoriesReport, } from './stories/index.js';
 export function makeLintCommand(configPath) {
     return Command.make('lint', {}, () => configPath.pipe(Effect.flatMap(runLint))).pipe(Command.withDescription('Check every configured architectural rule.'), Command.withSubcommands([
         makeLayersCommand(configPath),
@@ -16,11 +18,19 @@ function runLint(configPath) {
         const result = yield* analyzeProject(configPath);
         yield* Console.log(renderLayerReport(result.layerAnalysis));
         yield* Console.log(renderModuleReport(result.moduleAnalysis));
+        const missingPages = yield* lintStories(configPath);
         if (result.layerAnalysis.unassignedFiles.length > 0 ||
             result.layerAnalysis.forbiddenImports.length > 0 ||
             result.layerAnalysis.layersWithoutModules.length > 0 ||
-            result.moduleAnalysis.violations.length > 0) {
+            result.moduleAnalysis.violations.length > 0 ||
+            missingPages > 0) {
             process.exitCode = 1;
         }
     });
 }
+// A project without a Stories path has no Story Groups to lint.
+function lintStories(configPath) {
+    return getStoryTree(configPath).pipe(Effect.flatMap((tree) => Console.log(renderStoriesReport(tree)).pipe(Effect.as(countGroupsWithoutPage(tree)))), Effect.catchTag('StoriesError', (error) => error.reason === 'no-stories-path'
+        ? Effect.succeed(0)
+        : Effect.die(error)));
+}

package/dist/cli/lint/stories/index.d.ts

@@ -0,0 +1,2 @@
+export { countGroupsWithoutPage, renderStoriesReport } from './report.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/lint/stories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/stories/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/lint/stories/index.js

@@ -0,0 +1,2 @@
+// The lint command uses these to report Story Groups missing their page.
+export { countGroupsWithoutPage, renderStoriesReport } from './report.js';

package/dist/cli/lint/stories/report.d.ts

@@ -0,0 +1,4 @@
+import type { StoryTree } from '../../../story/schema/index.js';
+export declare function renderStoriesReport(tree: StoryTree): string;
+export declare function countGroupsWithoutPage(tree: StoryTree): number;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/lint/stories/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/stories/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,gCAAgC,CAAC;AAEhF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAY3D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE9D"}

package/dist/cli/lint/stories/report.js

@@ -0,0 +1,24 @@
+import * as colors from 'yoctocolors';
+export function renderStoriesReport(tree) {
+    const missing = groupsWithoutPage(tree, []);
+    if (missing.length === 0) {
+        return colors.green('✓ Every Story Group has a page');
+    }
+    return [
+        colors.red('Story Groups without a page'),
+        '',
+        ...missing.map((id) => `  ${colors.yellow('✕')} ${id}`),
+        '',
+        `${missing.length} ${missing.length === 1 ? 'group' : 'groups'}`,
+    ].join('\n');
+}
+export function countGroupsWithoutPage(tree) {
+    return groupsWithoutPage(tree, []).length;
+}
+function groupsWithoutPage(group, path) {
+    const id = [...path, group.title];
+    return [
+        ...(group.page === null ? [id.join('/')] : []),
+        ...group.groups.flatMap((child) => groupsWithoutPage(child, id)),
+    ];
+}

package/dist/domain/project-config/project-config.d.ts

@@ -10,10 +10,12 @@ export declare function decodeProjectConfig(input: unknown): import("effect/Effe
     readonly sourceRoots: readonly string[];
     readonly ignoredPaths: readonly string[];
     readonly storiesPath?: string | undefined;
+    readonly storyTimeout?: string | undefined;
     readonly layers: {
         readonly [x: string]: {
             readonly paths: readonly string[];
             readonly description?: string | undefined;
+            readonly docsPath?: string | undefined;
             readonly modules: {
                 readonly [x: string]: {
                     readonly shared: boolean;
@@ -24,6 +26,7 @@ export declare function decodeProjectConfig(input: unknown): import("effect/Effe
                 readonly [x: string]: {
                     readonly description?: string | undefined;
                     readonly path: string;
+                    readonly docsPath?: string | undefined;
                     readonly modules: {
                         readonly [x: string]: {
                             readonly shared: boolean;
@@ -40,6 +43,7 @@ export declare function decodeProjectConfig(input: unknown): import("effect/Effe
     readonly layerGraphs: {
         readonly [x: string]: {
             readonly description?: string | undefined;
+            readonly docsPath?: string | undefined;
             readonly rules: {
                 readonly [x: string]: readonly string[];
             };

package/dist/domain/project-config/project-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../../src/domain/project-config/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAEjD;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GACb,SAAS,qBAAqB,EAAE,CAElC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GACtB,SAAS,qBAAqB,EAAE,CAoBlC;AAED,wBAAgB,uBAAuB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAM3E"}
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../../src/domain/project-config/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAEjD;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GACb,SAAS,qBAAqB,EAAE,CAElC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GACtB,SAAS,qBAAqB,EAAE,CAoBlC;AAED,wBAAgB,uBAAuB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAM3E"}

package/dist/domain/project-config/validation/paths.js

@@ -17,10 +17,26 @@ function configPaths(config) {
             location: `ignoredPaths[${index}]`,
             path,
         })),
-        ...Object.entries(config.layers).flatMap(([layer, value]) => value.paths.map((path, index) => ({
-            location: `layers.${layer}.paths[${index}]`,
-            path,
-        }))),
+        ...Object.entries(config.layers).flatMap(([layer, value]) => [
+            ...value.paths.map((path, index) => ({
+                location: `layers.${layer}.paths[${index}]`,
+                path,
+            })),
+            ...(value.docsPath === undefined
+                ? []
+                : [{ location: `layers.${layer}.docsPath`, path: value.docsPath }]),
+            ...Object.entries(value.moduleGraphs).flatMap(([graph, graphValue]) => graphValue.docsPath === undefined
+                ? []
+                : [
+                    {
+                        location: `layers.${layer}.moduleGraphs.${graph}.docsPath`,
+                        path: graphValue.docsPath,
+                    },
+                ]),
+        ]),
+        ...Object.entries(config.layerGraphs).flatMap(([graph, value]) => value.docsPath === undefined
+            ? []
+            : [{ location: `layerGraphs.${graph}.docsPath`, path: value.docsPath }]),
     ];
 }
 function isCanonicalProjectPath(path) {

package/dist/index.d.ts

@@ -1,9 +1,13 @@
 export { analyzeProject } from './orchestrator/analyze-project/index.js';
 export { loadModuleSource, ModuleSourceNotFound, ModuleSourceReadError, } from './orchestrator/load-module-source/index.js';
+export { loadDocumentation, DocumentationReadError, DocumentationScopeNotFound, } from './orchestrator/load-documentation/index.js';
+export { loadSourceFiles, SourceFileReadError, } from './orchestrator/load-source-files/index.js';
 export { ArchitectureAnalysisSchema } from './architecture-analysis-schema/index.js';
 export type { ArchitectureAnalysis } from './architecture-analysis-schema/index.js';
 export { ModuleSourceSnapshotSchema } from './architecture-analysis-schema/index.js';
 export type { ModuleSourceFile, ModuleSourceSnapshot, } from './architecture-analysis-schema/index.js';
+export { DocumentationScopeSchema, DocumentationSchema, } from './architecture-analysis-schema/index.js';
+export type { Documentation, DocumentationScope, } from './architecture-analysis-schema/index.js';
 export { InspectionTargetNotFound, ModuleInspectionCycle, inspectFile, inspectLayer, inspectModule, inspectProject, } from './orchestrator/inspect/index.js';
 export type { FileInspection, FileInspectionOptions, LayerInspection, ModuleInspection, ProjectInspection, } from './orchestrator/inspect/index.js';
 export { ConfigError } from './services/config/index.js';
@@ -11,8 +15,8 @@ export { CruiseError } from './services/file-cruiser/index.js';
 export { getStoryTree, planStories, runStories, StoriesError, } from './orchestrator/run-stories/index.js';
 export { StoryReportSchema, StoryTreeSchema } from './story/schema/index.js';
 export type { StoryReport, StoryTree } from './story/schema/index.js';
-export { loadChangeSet, loadFileDiff, } from './orchestrator/load-changes/index.js';
+export { loadBranches, loadChangeSet, loadFileDiff, } from './orchestrator/load-changes/index.js';
 export { GitError } from './services/git/index.js';
-export { ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema/index.js';
-export type { ChangedPath, ChangeSet, ChangeStatus, DiffHunk, DiffLine, FileDiff, } from './change-set-schema/index.js';
+export { BranchSchema, ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema/index.js';
+export type { Branch, ChangedPath, ChangeSet, ChangeStatus, DiffHunk, DiffLine, FileDiff, } from './change-set-schema/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAErF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE/D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EACL,aAAa,EACb,YAAY,GACb,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAErF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE/D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,MAAM,EACN,WAAW,EACX,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -2,9 +2,14 @@
 export { analyzeProject } from './orchestrator/analyze-project/index.js';
 // Node consumers use this high-level capability to inspect one Configured Module.
 export { loadModuleSource, ModuleSourceNotFound, ModuleSourceReadError, } from './orchestrator/load-module-source/index.js';
+// Node consumers use this high-level capability to read documentation at any scope.
+export { loadDocumentation, DocumentationReadError, DocumentationScopeNotFound, } from './orchestrator/load-documentation/index.js';
+// Node consumers use this high-level capability to read arbitrary source files by path.
+export { loadSourceFiles, SourceFileReadError, } from './orchestrator/load-source-files/index.js';
 // RPC transports use this browser-safe runtime contract for Architecture Analysis.
 export { ArchitectureAnalysisSchema } from './architecture-analysis-schema/index.js';
 export { ModuleSourceSnapshotSchema } from './architecture-analysis-schema/index.js';
+export { DocumentationScopeSchema, DocumentationSchema, } from './architecture-analysis-schema/index.js';
 export { InspectionTargetNotFound, ModuleInspectionCycle, inspectFile, inspectLayer, inspectModule, inspectProject, } from './orchestrator/inspect/index.js';
 // Analysis callers distinguish Config loading and validation failures.
 export { ConfigError } from './services/config/index.js';
@@ -15,8 +20,8 @@ export { getStoryTree, planStories, runStories, StoriesError, } from './orchestr
 // RPC transports use this browser-safe runtime contract for Story reports.
 export { StoryReportSchema, StoryTreeSchema } from './story/schema/index.js';
 // Node consumers use this high-level capability to report what a Base ref changed.
-export { loadChangeSet, loadFileDiff, } from './orchestrator/load-changes/index.js';
+export { loadBranches, loadChangeSet, loadFileDiff, } from './orchestrator/load-changes/index.js';
 // Change set callers distinguish a missing repository from a failed git command.
 export { GitError } from './services/git/index.js';
 // RPC transports use this browser-safe runtime contract for Change sets.
-export { ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema/index.js';
+export { BranchSchema, ChangedPathSchema, ChangeSetSchema, ChangeStatusSchema, DiffHunkSchema, DiffLineSchema, FileDiffSchema, } from './change-set-schema/index.js';

package/dist/orchestrator/analyze-project/analyze-project.d.ts

@@ -5,10 +5,12 @@ export declare function analyzeProject(configPath: string): Effect.Effect<{
         readonly sourceRoots: readonly string[];
         readonly ignoredPaths: readonly string[];
         readonly storiesPath?: string | undefined;
+        readonly storyTimeout?: string | undefined;
         readonly layers: {
             readonly [x: string]: {
                 readonly paths: readonly string[];
                 readonly description?: string | undefined;
+                readonly docsPath?: string | undefined;
                 readonly modules: {
                     readonly [x: string]: {
                         readonly shared: boolean;
@@ -19,6 +21,7 @@ export declare function analyzeProject(configPath: string): Effect.Effect<{
                     readonly [x: string]: {
                         readonly description?: string | undefined;
                         readonly path: string;
+                        readonly docsPath?: string | undefined;
                         readonly modules: {
                             readonly [x: string]: {
                                 readonly shared: boolean;
@@ -35,6 +38,7 @@ export declare function analyzeProject(configPath: string): Effect.Effect<{
         readonly layerGraphs: {
             readonly [x: string]: {
                 readonly description?: string | undefined;
+                readonly docsPath?: string | undefined;
                 readonly rules: {
                     readonly [x: string]: readonly string[];
                 };

package/dist/orchestrator/analyze-project/analyze-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-project.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/analyze-project/analyze-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+HAShD"}
+{"version":3,"file":"analyze-project.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/analyze-project/analyze-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+HAShD"}

package/dist/orchestrator/inspect/inspect.d.ts

@@ -53,10 +53,12 @@ export declare function inspectProject(configPath: string): Effect.Effect<{
         readonly sourceRoots: readonly string[];
         readonly ignoredPaths: readonly string[];
         readonly storiesPath?: string | undefined;
+        readonly storyTimeout?: string | undefined;
         readonly layers: {
             readonly [x: string]: {
                 readonly paths: readonly string[];
                 readonly description?: string | undefined;
+                readonly docsPath?: string | undefined;
                 readonly modules: {
                     readonly [x: string]: {
                         readonly shared: boolean;
@@ -67,6 +69,7 @@ export declare function inspectProject(configPath: string): Effect.Effect<{
                     readonly [x: string]: {
                         readonly description?: string | undefined;
                         readonly path: string;
+                        readonly docsPath?: string | undefined;
                         readonly modules: {
                             readonly [x: string]: {
                                 readonly shared: boolean;
@@ -83,6 +86,7 @@ export declare function inspectProject(configPath: string): Effect.Effect<{
         readonly layerGraphs: {
             readonly [x: string]: {
                 readonly description?: string | undefined;
+                readonly docsPath?: string | undefined;
                 readonly rules: {
                     readonly [x: string]: readonly string[];
                 };
@@ -169,6 +173,7 @@ export declare function inspectLayer(configPath: string, target: string): Effect
     definition: {
         readonly paths: readonly string[];
         readonly description?: string | undefined;
+        readonly docsPath?: string | undefined;
         readonly modules: {
             readonly [x: string]: {
                 readonly shared: boolean;
@@ -179,6 +184,7 @@ export declare function inspectLayer(configPath: string, target: string): Effect
             readonly [x: string]: {
                 readonly description?: string | undefined;
                 readonly path: string;
+                readonly docsPath?: string | undefined;
                 readonly modules: {
                     readonly [x: string]: {
                         readonly shared: boolean;