laymos 0.0.7 → 0.0.8

package/dist/orchestrator/load-documentation/errors.js

@@ -0,0 +1,5 @@
+import { Data } from 'effect';
+export class DocumentationScopeNotFound extends Data.TaggedError('DocumentationScopeNotFound') {
+}
+export class DocumentationReadError extends Data.TaggedError('DocumentationReadError') {
+}

package/dist/orchestrator/load-documentation/index.d.ts

@@ -0,0 +1,2 @@
+export { loadDocumentation, DocumentationReadError, DocumentationScopeNotFound, } from './load-documentation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/load-documentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-documentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

package/dist/orchestrator/load-documentation/index.js

@@ -0,0 +1 @@
+export { loadDocumentation, DocumentationReadError, DocumentationScopeNotFound, } from './load-documentation.js';

package/dist/orchestrator/load-documentation/load-documentation.d.ts

@@ -0,0 +1,23 @@
+import { Effect } from 'effect';
+import type { DocumentationScope } from '../../architecture-analysis-schema/index.js';
+import { DocumentationReadError, DocumentationScopeNotFound } from './errors.js';
+export { DocumentationReadError, DocumentationScopeNotFound, } from './errors.js';
+export declare function loadDocumentation(configPath: string, scope: DocumentationScope): Effect.Effect<{
+    scope: {
+        readonly kind: "module";
+        readonly modulePath: string;
+    } | {
+        readonly kind: "module-graph";
+        readonly layerId: string;
+        readonly graphId: string;
+    } | {
+        readonly kind: "layer";
+        readonly layerId: string;
+    } | {
+        readonly kind: "layer-graph";
+        readonly graphId: string;
+    };
+    path: string | undefined;
+    content: string | undefined;
+}, import("../../services/config/errors.js").ConfigError | import("../../services/file-cruiser/errors.js").CruiseError | DocumentationReadError | DocumentationScopeNotFound, never>;
+//# sourceMappingURL=load-documentation.d.ts.map

package/dist/orchestrator/load-documentation/load-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-documentation.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-documentation/load-documentation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,6CAA6C,CAAC;AAKrD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;;qLA0C1B"}

package/dist/orchestrator/load-documentation/load-documentation.js

@@ -0,0 +1,66 @@
+import { dirname, resolve } from 'node:path';
+import { NodeServices } from '@effect/platform-node';
+import { Effect, FileSystem } from 'effect';
+import { analyzeArchitecture } from '../../domain/architecture-analysis/index.js';
+import { ConfigServiceLive } from '../../services/config/index.js';
+import { CruiserLive } from '../../services/file-cruiser/index.js';
+import { loadProject } from '../load-project/index.js';
+import { DocumentationReadError, DocumentationScopeNotFound, } from './errors.js';
+export { DocumentationReadError, DocumentationScopeNotFound, } from './errors.js';
+export function loadDocumentation(configPath, scope) {
+    const absoluteConfigPath = resolve(configPath);
+    const baseDir = dirname(absoluteConfigPath);
+    return Effect.gen(function* () {
+        const { config, fileGraph } = yield* loadProject(absoluteConfigPath);
+        const analysis = analyzeArchitecture(fileGraph, config);
+        const fileSystem = yield* FileSystem.FileSystem;
+        const declaredPath = yield* resolveDeclaredPath(config, scope, analysis);
+        if (declaredPath === undefined) {
+            return {
+                scope,
+                path: undefined,
+                content: undefined,
+            };
+        }
+        const content = yield* fileSystem
+            .readFileString(resolve(baseDir, declaredPath))
+            .pipe(Effect.catchIf((cause) => scope.kind === 'module' && cause.reason._tag === 'NotFound', () => Effect.succeed(undefined)), Effect.mapError((cause) => new DocumentationReadError({ path: declaredPath, cause })));
+        return {
+            scope,
+            path: content === undefined ? undefined : declaredPath,
+            content,
+        };
+    }).pipe(Effect.provide(ConfigServiceLive), Effect.provide(CruiserLive), Effect.provide(NodeServices.layer));
+}
+function resolveDeclaredPath(config, scope, analysis) {
+    switch (scope.kind) {
+        case 'module': {
+            const module = analysis.moduleAnalysis.modules.find(({ path }) => path === scope.modulePath);
+            if (module === undefined) {
+                return Effect.fail(new DocumentationScopeNotFound({ scope }));
+            }
+            return Effect.succeed(module.shape === 'directory' ? `${module.path}/README.md` : undefined);
+        }
+        case 'module-graph': {
+            const graph = config.layers[scope.layerId]?.moduleGraphs[scope.graphId];
+            if (graph === undefined) {
+                return Effect.fail(new DocumentationScopeNotFound({ scope }));
+            }
+            return Effect.succeed(graph.docsPath);
+        }
+        case 'layer': {
+            const layer = config.layers[scope.layerId];
+            if (layer === undefined) {
+                return Effect.fail(new DocumentationScopeNotFound({ scope }));
+            }
+            return Effect.succeed(layer.docsPath);
+        }
+        case 'layer-graph': {
+            const layerGraph = config.layerGraphs[scope.graphId];
+            if (layerGraph === undefined) {
+                return Effect.fail(new DocumentationScopeNotFound({ scope }));
+            }
+            return Effect.succeed(layerGraph.docsPath);
+        }
+    }
+}

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

@@ -13,10 +13,12 @@ export declare function loadProject(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;
@@ -27,6 +29,7 @@ export declare function loadProject(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;
@@ -43,6 +46,7 @@ export declare function loadProject(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/load-project/load-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-project.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-project/load-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACL,KAAK,MAAM,EAEZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA4B7C"}
+{"version":3,"file":"load-project.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-project/load-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACL,KAAK,MAAM,EAEZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA4B7C"}

package/dist/orchestrator/load-source-files/errors.d.ts

@@ -0,0 +1,10 @@
+declare const SourceFileReadError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SourceFileReadError";
+} & Readonly<A>;
+export declare class SourceFileReadError extends SourceFileReadError_base<{
+    readonly filePath: string;
+    readonly cause: unknown;
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/orchestrator/load-source-files/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-source-files/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG"}

package/dist/orchestrator/load-source-files/errors.js

@@ -0,0 +1,3 @@
+import { Data } from 'effect';
+export class SourceFileReadError extends Data.TaggedError('SourceFileReadError') {
+}

package/dist/orchestrator/load-source-files/index.d.ts

@@ -0,0 +1,2 @@
+export { loadSourceFiles, SourceFileReadError } from './load-source-files.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/load-source-files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-source-files/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/orchestrator/load-source-files/index.js

@@ -0,0 +1 @@
+export { loadSourceFiles, SourceFileReadError } from './load-source-files.js';

package/dist/orchestrator/load-source-files/load-source-files.d.ts

@@ -0,0 +1,16 @@
+import { Effect } from 'effect';
+import { SourceFileReadError } from './errors.js';
+export { SourceFileReadError } from './errors.js';
+/**
+ * Reads every analyzed file at or below one of the given project-relative
+ * path prefixes — a Configured Module's, Module Graph's, or Layer scope's
+ * own root. A prefix outside the analysis universe matches nothing, so a
+ * caller can never use this to read a file outside the Project.
+ */
+export declare function loadSourceFiles(configPath: string, pathPrefixes: readonly string[]): Effect.Effect<{
+    files: {
+        readonly path: string;
+        readonly content: string;
+    }[];
+}, import("../../services/config/errors.js").ConfigError | import("../../services/file-cruiser/errors.js").CruiseError | SourceFileReadError, never>;
+//# sourceMappingURL=load-source-files.d.ts.map

package/dist/orchestrator/load-source-files/load-source-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-source-files.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-source-files/load-source-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAM5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,MAAM,EAAE;;;;;qJA2BhC"}

package/dist/orchestrator/load-source-files/load-source-files.js

@@ -0,0 +1,30 @@
+import { dirname, resolve } from 'node:path';
+import { NodeServices } from '@effect/platform-node';
+import { Effect, FileSystem } from 'effect';
+import { ConfigServiceLive } from '../../services/config/index.js';
+import { CruiserLive } from '../../services/file-cruiser/index.js';
+import { loadProject } from '../load-project/index.js';
+import { SourceFileReadError } from './errors.js';
+export { SourceFileReadError } from './errors.js';
+/**
+ * Reads every analyzed file at or below one of the given project-relative
+ * path prefixes — a Configured Module's, Module Graph's, or Layer scope's
+ * own root. A prefix outside the analysis universe matches nothing, so a
+ * caller can never use this to read a file outside the Project.
+ */
+export function loadSourceFiles(configPath, pathPrefixes) {
+    const absoluteConfigPath = resolve(configPath);
+    const baseDir = dirname(absoluteConfigPath);
+    return Effect.gen(function* () {
+        const { fileGraph } = yield* loadProject(absoluteConfigPath);
+        const paths = [...fileGraph.keys()]
+            .filter((path) => underAnyPrefix(path, pathPrefixes))
+            .sort((left, right) => left.localeCompare(right));
+        const fileSystem = yield* FileSystem.FileSystem;
+        const files = yield* Effect.forEach(paths, (path) => fileSystem.readFileString(resolve(baseDir, path)).pipe(Effect.map((content) => ({ path, content })), Effect.mapError((cause) => new SourceFileReadError({ filePath: path, cause }))));
+        return { files };
+    }).pipe(Effect.provide(ConfigServiceLive), Effect.provide(CruiserLive), Effect.provide(NodeServices.layer));
+}
+function underAnyPrefix(path, pathPrefixes) {
+    return pathPrefixes.some((prefix) => prefix === '.' || path === prefix || path.startsWith(`${prefix}/`));
+}

package/dist/orchestrator/run-stories/errors.d.ts

@@ -2,7 +2,7 @@ declare const StoriesError_base: new <A extends Record<string, any> = {}>(args:
     readonly _tag: "StoriesError";
 } & Readonly<A>;
 export declare class StoriesError extends StoriesError_base<{
-    readonly reason: 'no-stories-path' | 'load' | 'invalid-root' | 'duplicate-title' | 'duplicate-question' | 'snippet-extraction' | 'unknown-scope';
+    readonly reason: 'no-stories-path' | 'load' | 'invalid-root' | 'duplicate-title' | 'duplicate-question' | 'snippet-extraction' | 'unknown-scope' | 'invalid-timeout';
     readonly path: string;
     readonly cause: unknown;
 }> {

package/dist/orchestrator/run-stories/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,MAAM,EACX,iBAAiB,GACjB,MAAM,GACN,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,MAAM,EACX,iBAAiB,GACjB,MAAM,GACN,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG"}

package/dist/orchestrator/run-stories/run-stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-stories.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/run-stories.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,MAAM,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;AAWrD,OAAO,KAAK,EAQV,WAAW,EAEX,SAAS,EAEV,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAUlE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,YAAY,CAAC,CAEtD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;CAC9C;AAID,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC,CAYvD;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY,CAAC,CAIxD"}
+{"version":3,"file":"run-stories.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/run-stories.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,MAAM,EAKN,MAAM,EACP,MAAM,QAAQ,CAAC;AAWhB,OAAO,KAAK,EAQV,WAAW,EAEX,SAAS,EAEV,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAUlE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,YAAY,CAAC,CAEtD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;CAC9C;AAmBD,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC,CAkBvD;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY,CAAC,CAIxD"}

package/dist/orchestrator/run-stories/run-stories.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, relative, resolve, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { Cause, Effect, Exit, Stream } from 'effect';
+import { Cause, Duration, Effect, Exit, Logger, Option, References, Stream, } from 'effect';
 import { NodeServices } from '@effect/platform-node';
 import { tsImport } from 'tsx/esm/api';
 import { isStory, isStoryGroup, StoryContext, } from '../../story/index.js';
@@ -13,22 +13,34 @@ export function getStoryTree(configPath) {
     return Effect.map(loadRoot(configPath), ({ tree }) => tree);
 }
 const DEFAULT_CONCURRENCY = 16;
+const DEFAULT_STORY_TIMEOUT = Duration.seconds(10);
+// The config names a Duration as text; a Story carries a typed DurationInput.
+function resolveTimeout(input, fallback, path) {
+    if (input === undefined)
+        return Effect.succeed(fallback);
+    return Option.match(Duration.fromInput(input), {
+        onNone: () => new StoriesError({ reason: 'invalid-timeout', path, cause: input }),
+        onSome: Effect.succeed,
+    });
+}
 export function planStories(configPath, options) {
     return Effect.gen(function* () {
-        const { stories } = yield* loadRoot(configPath);
+        const { stories, storyTimeout } = yield* loadRoot(configPath);
+        const timeout = yield* resolveTimeout(storyTimeout, DEFAULT_STORY_TIMEOUT, configPath);
         const planned = yield* scopeStories(stories, options?.scope);
         return {
             total: planned.length,
-            reports: runEachStory(planned, options?.concurrency ?? DEFAULT_CONCURRENCY),
+            reports: yield* runEachStory(planned, options?.concurrency ?? DEFAULT_CONCURRENCY, timeout),
         };
     });
 }
 export function runStories(configPath, options) {
     return Stream.unwrap(Effect.map(planStories(configPath, options), ({ reports }) => reports));
 }
-function runEachStory(stories, concurrency) {
+function runEachStory(stories, concurrency, timeout) {
+    return Effect.map(Effect.forEach(stories, (indexed) => Effect.map(resolveTimeout(indexed.story.timeout, timeout, indexed.id), (budget) => ({ indexed, budget }))), (planned) => 
     // Ordered concurrent mapping needs three slots; anything less runs one at a time.
-    return Stream.fromArray(stories).pipe(Stream.mapEffect(runStory, concurrency >= 3 ? { concurrency } : undefined));
+    Stream.fromArray(planned).pipe(Stream.mapEffect(({ indexed, budget }) => runStory(indexed, budget), concurrency >= 3 ? { concurrency } : undefined)));
 }
 function scopeStories(stories, scope) {
     if (scope === undefined)
@@ -74,6 +86,7 @@ function loadRoot(configPath) {
         const indexed = yield* indexGroup(root, [root.title], entryPoint, options);
         return {
             ...indexed,
+            storyTimeout: config.storyTimeout,
             tree: attachGroupPages(indexed.tree, indexed.directory, options.projectRoot, options.groupDirectories),
         };
     }).pipe(Effect.provide(ConfigServiceLive), Effect.provide(NodeServices.layer));
@@ -283,12 +296,27 @@ function checkUniqueTitles(children, path, entryPoint) {
     }
     return Effect.void;
 }
-function runStory({ id, story }) {
+function runStory({ id, story }, timeout) {
     return Effect.gen(function* () {
         const questions = [];
-        for (const question of story.questions) {
-            questions.push(yield* runQuestion(question));
-        }
+        // One budget for the whole Story: a hanging proof becomes an errored
+        // verdict instead of wedging the run.
+        yield* Effect.gen(function* () {
+            for (const question of story.questions) {
+                questions.push(yield* runQuestion(question));
+            }
+        }).pipe(Effect.timeout(timeout), Effect.catchTag('TimeoutError', () => Effect.sync(() => {
+            const interrupted = story.questions[questions.length];
+            if (interrupted !== undefined) {
+                questions.push({
+                    slug: slugifyQuestion(interrupted.question),
+                    verdict: 'errored',
+                    error: `Story timed out after ${Duration.format(timeout)}`,
+                    assertions: [],
+                    sections: [],
+                });
+            }
+        })));
         const verdict = questions.some(({ verdict }) => verdict === 'errored')
             ? 'errored'
             : questions.some(({ verdict }) => verdict === 'failed')
@@ -308,7 +336,10 @@ function runQuestion(question) {
             assert: (description, passed) => Effect.sync(() => {
                 assertions.push({ description, passed });
             }),
-        }), Effect.exit);
+        }), 
+        // A proof must see the same logging whatever host runs it: a Story
+        // that captures its own logs cannot depend on the host's log level.
+        Effect.provideService(References.MinimumLogLevel, 'Info'), Effect.provide(Logger.layer([])), Effect.exit);
         const slug = slugifyQuestion(question.question);
         if (Exit.isFailure(exit)) {
             return {

package/dist/services/git/changed-paths.d.ts

@@ -1,4 +1,5 @@
-import type { ChangeSet, DiffHunk } from '../../change-set-schema/index.js';
+import type { Branch, ChangeSet, DiffHunk } from '../../change-set-schema/index.js';
 export declare function readChangeSet(baseDir: string, baseRef: string): Promise<ChangeSet>;
 export declare function readFileDiff(baseDir: string, baseRef: string, path: string): Promise<readonly DiffHunk[]>;
+export declare function listBranches(baseDir: string): Promise<Branch[]>;
 //# sourceMappingURL=changed-paths.d.ts.map

package/dist/services/git/changed-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changed-paths.d.ts","sourceRoot":"","sources":["../../../src/services/git/changed-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAET,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAY1C,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CA+BpB;AA8CD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAiB9B"}
+{"version":3,"file":"changed-paths.d.ts","sourceRoot":"","sources":["../../../src/services/git/changed-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAEN,SAAS,EAET,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAY1C,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CA+BpB;AA8CD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAiB9B;AAYD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBrE"}

package/dist/services/git/changed-paths.js

@@ -1,5 +1,5 @@
 import { parsePatch } from './parse-patch.js';
-import { requireGit, splitNul } from './run-git.js';
+import { requireGit, runGit, splitNul } from './run-git.js';
 const wholeFileContext = 1000000;
 export async function readChangeSet(baseDir, baseRef) {
     await requireGit(baseDir, ['rev-parse', '--show-toplevel'], 'not-a-repo');
@@ -71,6 +71,21 @@ async function resolveBase(baseDir, baseRef) {
     const mergeBase = await requireGit(baseDir, ['merge-base', baseRef, 'HEAD'], 'unknown-ref');
     return mergeBase.trim();
 }
+export async function listBranches(baseDir) {
+    await requireGit(baseDir, ['rev-parse', '--show-toplevel'], 'not-a-repo');
+    const current = (await runGit(baseDir, ['symbolic-ref', '--short', 'HEAD'])).stdout.trim();
+    const local = splitLines(await requireGit(baseDir, ['for-each-ref', '--format=%(refname:short)', 'refs/heads'], 'command-failed')).map((name) => ({ name, remote: false, current: name === current }));
+    const remote = splitLines(await requireGit(baseDir, ['for-each-ref', '--format=%(refname:short)', 'refs/remotes'], 'command-failed'))
+        .filter((name) => !name.endsWith('/HEAD'))
+        .map((name) => ({ name, remote: true, current: false }));
+    return [...local, ...remote];
+}
+function splitLines(stdout) {
+    return stdout
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line !== '');
+}
 function trackedStatus(code) {
     switch (code.charAt(0)) {
         case 'A':

package/dist/services/git/git.d.ts

@@ -1,9 +1,10 @@
 import { Context, Effect, Layer } from 'effect';
-import type { ChangeSet, FileDiff } from '../../change-set-schema/index.js';
+import type { Branch, ChangeSet, FileDiff } from '../../change-set-schema/index.js';
 import { GitError } from './errors.js';
 declare const Git_base: Context.ServiceClass<Git, "Git", {
     readonly changeSet: (baseDir: string, baseRef: string) => Effect.Effect<ChangeSet, GitError>;
     readonly fileDiff: (baseDir: string, baseRef: string, path: string) => Effect.Effect<FileDiff, GitError>;
+    readonly branches: (baseDir: string) => Effect.Effect<readonly Branch[], GitError>;
 }>;
 export declare class Git extends Git_base {
 }

package/dist/services/git/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/services/git/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;;wBAKf,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;uBACpB,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;;AAX1C,qBAAa,GAAI,SAAQ,QAaf;CAAG;AAEb,eAAO,MAAM,OAAO,gCAclB,CAAC"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/services/git/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;;wBAKf,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;uBACpB,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;uBACnB,CACjB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC;;AAdnD,qBAAa,GAAI,SAAQ,QAgBf;CAAG;AAEb,eAAO,MAAM,OAAO,gCAmBlB,CAAC"}

package/dist/services/git/git.js

@@ -1,5 +1,5 @@
 import { Context, Effect, Layer } from 'effect';
-import { readChangeSet, readFileDiff } from './changed-paths.js';
+import { listBranches, readChangeSet, readFileDiff } from './changed-paths.js';
 import { GitError } from './errors.js';
 export class Git extends Context.Service()('Git') {
 }
@@ -15,6 +15,10 @@ export const GitLive = Layer.succeed(Git)({
         }),
         catch: (cause) => asGitError(cause, baseDir),
     }),
+    branches: (baseDir) => Effect.tryPromise({
+        try: () => listBranches(baseDir),
+        catch: (cause) => asGitError(cause, baseDir),
+    }),
 });
 function asGitError(cause, baseDir) {
     return cause instanceof GitError

package/dist/story/schema/story-report-schema.d.ts

@@ -120,16 +120,6 @@ export declare const QuestionSectionSchema: Schema.Union<readonly [Schema.Struct
             readonly destination: Schema.String;
             readonly messageId: Schema.String;
             readonly replyTo: Schema.optional<Schema.String>;
-        }>, Schema.Struct<{
-            readonly id: Schema.String;
-            readonly participantName: Schema.String;
-            readonly name: Schema.String;
-            readonly timestamp: Schema.Number;
-            readonly attributes: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>>;
-            readonly kind: Schema.Literal<"state">;
-            readonly severity: Schema.Literals<readonly ["debug", "error", "info", "warning"]>;
-            readonly state: Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>;
-            readonly merged: Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>;
         }>]>>;
         readonly activations: Schema.$Array<Schema.Struct<{
             readonly participantName: Schema.String;
@@ -243,16 +233,6 @@ export declare const QuestionReportSchema: Schema.Struct<{
                 readonly destination: Schema.String;
                 readonly messageId: Schema.String;
                 readonly replyTo: Schema.optional<Schema.String>;
-            }>, Schema.Struct<{
-                readonly id: Schema.String;
-                readonly participantName: Schema.String;
-                readonly name: Schema.String;
-                readonly timestamp: Schema.Number;
-                readonly attributes: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>>;
-                readonly kind: Schema.Literal<"state">;
-                readonly severity: Schema.Literals<readonly ["debug", "error", "info", "warning"]>;
-                readonly state: Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>;
-                readonly merged: Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>;
             }>]>>;
             readonly activations: Schema.$Array<Schema.Struct<{
                 readonly participantName: Schema.String;
@@ -369,16 +349,6 @@ export declare const StoryReportSchema: Schema.Struct<{
                     readonly destination: Schema.String;
                     readonly messageId: Schema.String;
                     readonly replyTo: Schema.optional<Schema.String>;
-                }>, Schema.Struct<{
-                    readonly id: Schema.String;
-                    readonly participantName: Schema.String;
-                    readonly name: Schema.String;
-                    readonly timestamp: Schema.Number;
-                    readonly attributes: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>>;
-                    readonly kind: Schema.Literal<"state">;
-                    readonly severity: Schema.Literals<readonly ["debug", "error", "info", "warning"]>;
-                    readonly state: Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>;
-                    readonly merged: Schema.$Record<Schema.String, Schema.Codec<import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, import("@pkishorez/effect-tracer/flow").RecordedFlowAttributeValue, never, never>>;
                 }>]>>;
                 readonly activations: Schema.$Array<Schema.Struct<{
                     readonly participantName: Schema.String;

package/dist/story/schema/story-report-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"story-report-schema.d.ts","sourceRoot":"","sources":["../../../src/story/schema/story-report-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAc9B,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,SAAS,EAAE,GACpB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAqC1C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EAQ9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;EAO/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAahC,CAAC;AAEH,eAAO,MAAM,kBAAkB,2DAI7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC"}
+{"version":3,"file":"story-report-schema.d.ts","sourceRoot":"","sources":["../../../src/story/schema/story-report-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAc9B,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,SAAS,EAAE,GACpB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAqC1C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EAQ9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;EAO/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAahC,CAAC;AAEH,eAAO,MAAM,kBAAkB,2DAI7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC"}

package/dist/story/story.d.ts

@@ -1,4 +1,4 @@
-import { Context, Effect } from 'effect';
+import { Context, Duration, Effect } from 'effect';
 import type { QuestionSection } from './schema/index.js';
 declare const StoryContext_base: Context.ServiceClass<StoryContext, "StoryContext", {
     readonly beginSection: (section: QuestionSection) => Effect.Effect<void>;
@@ -17,6 +17,8 @@ export interface Story {
     readonly spine: boolean;
     readonly sourceUrl: string;
     readonly questions: readonly StoryQuestion[];
+    /** How long this Story may run before it is failed; overrides the config-wide Story timeout. */
+    readonly timeout?: Duration.Input;
 }
 export interface StoryGroup {
     readonly title: string;

package/dist/story/story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../src/story/story.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;;2BAK9B,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;qBACvD,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;AAP5B,qBAAa,YAAa,SAAQ,iBASf;CAAG;AAEtB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAE3C,eAAO,MAAM,KAAK;IAChB,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK;IAIvE,QAAQ,WACI,MAAM,WACP;QACP,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;KAC/D,GACA,aAAa;IAIhB,KAAK,QACI,MAAM,WACJ;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,YAC/B,SAAS,SAAS,EAAE,GAC7B,UAAU;IAIb,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IAcxC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UACF,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IAgBxC,MAAM,cACS,MAAM,UACX,OAAO,GACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC;CAK5C,CAAC;AAEF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAgBtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAWhE"}
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../src/story/story.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;;2BAK9B,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;qBACvD,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;AAP5B,qBAAa,YAAa,SAAQ,iBASf;CAAG;AAEtB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAE3C,eAAO,MAAM,KAAK;IAChB,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK;IAIvE,QAAQ,WACI,MAAM,WACP;QACP,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;KAC/D,GACA,aAAa;IAIhB,KAAK,QACI,MAAM,WACJ;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,YAC/B,SAAS,SAAS,EAAE,GAC7B,UAAU;IAIb,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IAcxC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UACF,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IAgBxC,MAAM,cACS,MAAM,UACX,OAAO,GACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC;CAK5C,CAAC;AAEF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAgBtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAWhE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laymos",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "private": false,
   "description": "Enforces architectural dependency rules and explores source dependencies.",
   "repository": {
@@ -53,7 +53,7 @@
     "oxc-resolver": "11.24.2",
     "tsx": "4.23.12",
     "yoctocolors": "2.2.0",
-    "@pkishorez/effect-tracer": "0.0.7"
+    "@pkishorez/effect-tracer": "0.0.8"
   },
   "devDependencies": {
     "@types/node": "26.2.0",

package/schema.json

@@ -43,6 +43,17 @@
       ],
       "description": "Canonical project-relative folder holding every Story file and the index.ts entry point exposing the Story Collection. Implicitly an Ignored path."
     },
+    "storyTimeout": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "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."
+    },
     "layers": {
       "type": "object",
       "additionalProperties": {
@@ -71,6 +82,9 @@
             ],
             "description": "Human-readable summary of this Layer."
           },
+          "docsPath": {
+            "$ref": "#/definitions/Union_"
+          },
           "modules": {
             "type": "object",
             "additionalProperties": {
@@ -98,6 +112,9 @@
                   "type": "string",
                   "description": "Canonical project-relative directory rooting this Module Graph. Every member lives below it and every file below it must belong to a member."
                 },
+                "docsPath": {
+                  "$ref": "#/definitions/Union_"
+                },
                 "modules": {
                   "type": "object",
                   "additionalProperties": {
@@ -162,6 +179,9 @@
             ],
             "description": "Human-readable summary of this LayerGraph."
           },
+          "docsPath": {
+            "$ref": "#/definitions/Union_"
+          },
           "rules": {
             "type": "object",
             "additionalProperties": {
@@ -192,6 +212,17 @@
   "title": "Laymos Config",
   "description": "Declares a project's Layers, their Modules and Module Graphs, and its LayerGraphs.",
   "definitions": {
+    "Union_": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Canonical project-relative path to a markdown file documenting this entity. Read-only: Laymos never writes to it."
+    },
     "Objects_": {
       "type": "object",
       "properties": {