laymos 0.0.1

package/dist/engine/errors.js

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './config/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from './config/index.js';

package/dist/node.d.ts

@@ -0,0 +1,24 @@
+import { Effect } from 'effect';
+import type { LaymosError } from './engine/errors.js';
+import type { LaymosReport } from './report/index.js';
+import type { StoryArtifact, StoryCatalog, StoryGroupPath } from './report/stories.js';
+import { StoryDiscoveryError, StoryRunnerError } from './story/runner/index.js';
+import type { StoryFailure, StoriesRunResult, StoryRunOptions } from './story/runner/index.js';
+export { ConfigLoadError, ExtractError } from './engine/errors.js';
+export { StoryDiscoveryError, StoryRunnerError } from './story/runner/index.js';
+export type { StoryDiscoveryIssue, StoriesRunResult, StoryFailure, StoryRunOptions, } from './story/runner/index.js';
+/** load config → extract → resolve → evaluate → emit; violations are data, config errors fail. */
+export declare function analyzeProject(baseDir: string): Effect.Effect<LaymosReport, LaymosError>;
+export interface StoryRunResult {
+    readonly status: 'passed' | 'failed';
+    readonly artifact: StoryArtifact;
+    readonly failures: readonly StoryFailure[];
+}
+export type AllStoriesRunResult = StoriesRunResult;
+export declare function discoverStories(baseDir: string): Effect.Effect<StoryCatalog, StoryDiscoveryError>;
+export declare function runStory(baseDir: string, storyId: string, options?: StoryRunOptions): Effect.Effect<StoryRunResult, StoryRunnerError>;
+export declare function runAllStories(baseDir: string, options?: StoryRunOptions): Effect.Effect<AllStoriesRunResult, StoryRunnerError>;
+export declare function runStoryGroup(baseDir: string, groupPath: StoryGroupPath, options?: StoryRunOptions): Effect.Effect<StoriesRunResult, StoryDiscoveryError | StoryRunnerError>;
+/** Runs the given Story files (all of them when empty) and returns fresh evidence. */
+export declare function runStories(baseDir: string, storyIds: readonly string[], options?: StoryRunOptions): Effect.Effect<StoriesRunResult, StoryRunnerError>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAUhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,kGAAkG;AAClG,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAa1C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEnD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAElD;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAqBjD;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAEtD;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,GAAG,gBAAgB,CAAC,CA0BzE;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAEnD"}

package/dist/node.js

@@ -0,0 +1,139 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Effect } from 'effect';
+import { createJiti } from 'jiti';
+import { defineConfig } from './config/define-config.js';
+import { extractFileGraph } from './engine/1-extract/index.js';
+import { resolveProject } from './engine/2-resolve/index.js';
+import { evaluateRules } from './engine/3-evaluate/index.js';
+import { emitReport } from './engine/4-emit/index.js';
+import { ConfigLoadError } from './engine/errors.js';
+import { discoverStories as discoverStoryCatalog, StoryRunnerError, executeStories, } from './story/runner/index.js';
+export { ConfigLoadError, ExtractError } from './engine/errors.js';
+export { StoryDiscoveryError, StoryRunnerError } from './story/runner/index.js';
+/** load config → extract → resolve → evaluate → emit; violations are data, config errors fail. */
+export function analyzeProject(baseDir) {
+    return Effect.gen(function* () {
+        const config = yield* loadConfig(baseDir);
+        const warnings = findMissingPathWarnings(baseDir, config);
+        const fileGraph = yield* extractFileGraph(baseDir, config.sourceRoots, config.ignore ?? []);
+        const resolved = yield* resolveProject(config, fileGraph);
+        const evaluation = yield* evaluateRules(resolved);
+        return yield* emitReport(resolved, evaluation, warnings);
+    });
+}
+export function discoverStories(baseDir) {
+    return discoverStoryCatalog(baseDir);
+}
+export function runStory(baseDir, storyId, options) {
+    return executeStories(baseDir, [storyId], options).pipe(Effect.flatMap((result) => {
+        const artifact = result.report.stories[storyId];
+        if (artifact === undefined) {
+            const cause = new Error(`Story "${storyId}" did not run`);
+            return Effect.fail(new StoryRunnerError({
+                operation: 'execute',
+                message: cause.message,
+                cause,
+            }));
+        }
+        return Effect.succeed({
+            status: result.status,
+            artifact,
+            failures: result.failures,
+        });
+    }));
+}
+export function runAllStories(baseDir, options) {
+    return executeStories(baseDir, [], options);
+}
+export function runStoryGroup(baseDir, groupPath, options) {
+    return discoverStories(baseDir).pipe(Effect.flatMap((catalog) => {
+        const groupExists = catalog.groups.some(({ path }) => samePath(path, groupPath));
+        if (!groupExists) {
+            const cause = new Error(`Story Group "${groupPath.join(' / ')}" was not found`);
+            return Effect.fail(new StoryRunnerError({
+                operation: 'execute',
+                message: cause.message,
+                cause,
+            }));
+        }
+        const storyIds = catalog.stories
+            .filter(({ groupPath: storyGroupPath }) => startsWithPath(storyGroupPath, groupPath))
+            .map(({ storyId }) => storyId);
+        return executeStories(baseDir, storyIds, options);
+    }));
+}
+/** Runs the given Story files (all of them when empty) and returns fresh evidence. */
+export function runStories(baseDir, storyIds, options) {
+    return executeStories(baseDir, storyIds, options);
+}
+function samePath(left, right) {
+    return (left.length === right.length &&
+        left.every((segment, index) => segment === right[index]));
+}
+function startsWithPath(path, prefix) {
+    return prefix.every((segment, index) => path[index] === segment);
+}
+function loadConfig(baseDir) {
+    const path = resolve(baseDir, 'laymos.config.ts');
+    return Effect.tryPromise({
+        try: async () => {
+            if (!existsSync(path)) {
+                throw new Error(`Config file not found: ${path}`);
+            }
+            const jiti = createJiti(import.meta.url, {
+                interopDefault: true,
+                moduleCache: false,
+            });
+            const imported = (await jiti.import(path));
+            const config = imported.default;
+            if (!isLaymosConfig(config)) {
+                throw new Error(`Config at "${path}" must default-export a value created with defineConfig()`);
+            }
+            return defineConfig(config);
+        },
+        catch: (cause) => new ConfigLoadError({ path, cause }),
+    });
+}
+function isLaymosConfig(value) {
+    if (typeof value !== 'object' || value === null || !('graphs' in value)) {
+        return false;
+    }
+    const config = value;
+    return (Array.isArray(config.graphs) &&
+        config.graphs.every((graph) => graph?.kind === 'layer-graph') &&
+        Array.isArray(config.sourceRoots) &&
+        (config.modules === undefined || Array.isArray(config.modules)) &&
+        (config.moduleRules === undefined || Array.isArray(config.moduleRules)) &&
+        (config.ignore === undefined || Array.isArray(config.ignore)));
+}
+function findMissingPathWarnings(baseDir, config) {
+    const warnings = [];
+    for (const path of config.sourceRoots) {
+        if (!existsSync(resolve(baseDir, path))) {
+            warnings.push({ kind: 'missing-source-root', path });
+        }
+    }
+    const layers = new Set(config.graphs.flatMap((graph) => [...graph.layers]));
+    for (const layer of layers) {
+        for (const path of layer.paths) {
+            if (!existsSync(resolve(baseDir, path))) {
+                warnings.push({
+                    kind: 'missing-layer-path',
+                    layer: layer.name,
+                    path,
+                });
+            }
+        }
+    }
+    for (const module of config.modules ?? []) {
+        if (!existsSync(resolve(baseDir, module.path))) {
+            warnings.push({
+                kind: 'missing-module-path',
+                module: module.path,
+                path: module.path,
+            });
+        }
+    }
+    return warnings;
+}

package/dist/report/architecture.d.ts

@@ -0,0 +1,104 @@
+export interface ReportLayer {
+    readonly paths: readonly string[];
+    readonly description?: string;
+}
+export interface ReportLayerEdge {
+    readonly from: string;
+    readonly to: string;
+}
+export interface ReportGraph {
+    readonly name: string;
+    readonly layers: readonly string[];
+    readonly edges: readonly ReportLayerEdge[];
+    readonly description?: string;
+}
+export interface ReportModule {
+    readonly description?: string;
+}
+export interface ReportModuleRules {
+    readonly module: string;
+    readonly canImport?: readonly string[];
+    readonly canImportedBy?: readonly string[];
+}
+export interface ReportArchitecture {
+    readonly sourceRoots: readonly string[];
+    readonly layers: Readonly<Record<string, ReportLayer>>;
+    readonly graphs: readonly ReportGraph[];
+    readonly modules: Readonly<Record<string, ReportModule>>;
+    readonly moduleRules: readonly ReportModuleRules[];
+    readonly ignoredPaths: readonly string[];
+}
+export type ReportFile = {
+    readonly kind: 'ignored';
+    readonly imports: readonly string[];
+} | {
+    readonly kind: 'uncovered';
+    readonly imports: readonly string[];
+} | {
+    readonly kind: 'covered';
+    readonly layer: string;
+    readonly module?: string;
+    readonly imports: readonly string[];
+};
+export interface LayerViolation {
+    readonly kind: 'layer';
+    readonly from: {
+        readonly layer: string;
+        readonly file: string;
+    };
+    readonly to: {
+        readonly layer: string;
+        readonly file: string;
+    };
+}
+export interface ModuleViolation {
+    readonly kind: 'module';
+    readonly rule: 'canImport' | 'canImportedBy';
+    readonly from: {
+        readonly module: string;
+        readonly layer: string;
+        readonly file: string;
+    };
+    readonly to: {
+        readonly module: string;
+        readonly layer: string;
+        readonly file: string;
+    };
+}
+export type Violation = LayerViolation | ModuleViolation;
+export interface LayerCoverage {
+    readonly totalFiles: number;
+    readonly coveredFiles: number;
+    readonly uncovered: readonly string[];
+}
+export interface ModuleCoverage {
+    readonly layer: string;
+    readonly totalFiles: number;
+    readonly coveredFiles: number;
+    readonly uncovered: readonly string[];
+}
+export interface Coverage {
+    readonly layers: LayerCoverage;
+    readonly modules: readonly ModuleCoverage[];
+}
+export type AnalysisWarning = {
+    readonly kind: 'missing-source-root';
+    readonly path: string;
+} | {
+    readonly kind: 'missing-layer-path';
+    readonly layer: string;
+    readonly path: string;
+} | {
+    readonly kind: 'missing-module-path';
+    readonly module: string;
+    readonly path: string;
+};
+export interface LaymosReport {
+    readonly schemaVersion: 2;
+    readonly architecture: ReportArchitecture;
+    readonly files: Readonly<Record<string, ReportFile>>;
+    readonly violations: readonly Violation[];
+    readonly coverage: Coverage;
+    readonly warnings: readonly AnalysisWarning[];
+}
+//# sourceMappingURL=architecture.d.ts.map

package/dist/report/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/report/architecture.ts"],"names":[],"mappings":"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"}

package/dist/report/architecture.js

@@ -0,0 +1 @@
+export {};

package/dist/report/index.d.ts

@@ -0,0 +1,3 @@
+export * from './architecture.js';
+export * from './stories.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/report/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/report/index.js

@@ -0,0 +1,2 @@
+export * from './architecture.js';
+export * from './stories.js';

package/dist/report/stories.d.ts

@@ -0,0 +1,22 @@
+import type { StoryArtifact, StoryId } from '../story/artifact/types.js';
+export type { BlockId, ExecutionItem, ExecutionPath, ScenarioOutcome, StoryArm, StoryArtifact, StoryBlock, StoryBlockVisitOutcome, StoryDecisionValue, StoryId, StoryScenario, StoryScenarioFailure, StoryScenarioFailurePhase, StorySelectedArm, StorySourceLocation, } from '../story/artifact/types.js';
+export interface LaymosStoriesReport {
+    readonly stories: Readonly<Record<StoryId, StoryArtifact>>;
+}
+export type StoryGroupPath = readonly string[];
+export interface StoryCatalogGroup {
+    readonly path: StoryGroupPath;
+    readonly name: string;
+    readonly description: string;
+}
+export interface StoryCatalogStory {
+    readonly storyId: StoryId;
+    readonly name: string;
+    readonly description: string;
+    readonly groupPath: StoryGroupPath;
+}
+export interface StoryCatalog {
+    readonly groups: readonly StoryCatalogGroup[];
+    readonly stories: readonly StoryCatalogStory[];
+}
+//# sourceMappingURL=stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stories.d.ts","sourceRoot":"","sources":["../../src/report/stories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEzE,YAAY,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,EACf,QAAQ,EACR,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,MAAM,EAAE,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD"}

package/dist/report/stories.js

@@ -0,0 +1 @@
+export {};

package/dist/story/artifact/artifact.d.ts

@@ -0,0 +1,57 @@
+import type { ExecutionPath, StoryBlock, StoryBlockVisitOutcome } from './types.js';
+import type { ArmDeclaration, BlockDeclaration, SelectedArm, StoryRecorder } from '../core/recorder.js';
+import type { Attributes } from '../core/types.js';
+interface MutableVisit {
+    readonly blockId: string;
+    outcome: StoryBlockVisitOutcome;
+    readonly startOffsetMillis: number;
+    durationMillis: number;
+    readonly selectedArm?: SelectedArm;
+    readonly attributes?: Readonly<Record<string, unknown>>;
+    readonly children: MutableExecutionItem[];
+}
+type MutableExecutionItem = MutableVisit | {
+    readonly parallel: MutableExecutionItem[][];
+};
+interface Container {
+    readonly items: MutableExecutionItem[];
+    readonly active: Set<VisitToken>;
+    parallel: {
+        readonly parallel: MutableExecutionItem[][];
+    } | undefined;
+}
+interface VisitToken {
+    readonly visit: MutableVisit;
+    readonly container: Container;
+    readonly children: Container;
+}
+export declare class StoryBlockRegistry {
+    private readonly baseDir;
+    private readonly blocks;
+    constructor(baseDir: string);
+    declare(block: BlockDeclaration): string;
+    declareArm(block: BlockDeclaration, arm: ArmDeclaration): void;
+    toRecord(): Readonly<Record<string, StoryBlock>>;
+}
+export declare class ScenarioRecorder implements StoryRecorder {
+    private readonly blocks;
+    private readonly root;
+    private readonly anchor;
+    private closed;
+    private active;
+    constructor(blocks: StoryBlockRegistry);
+    declareArm(block: BlockDeclaration, arm: ArmDeclaration): void;
+    start(block: BlockDeclaration, selectedArm: SelectedArm | undefined, attributes: Attributes | undefined, parent: unknown): VisitToken;
+    finish(token: unknown, outcome: StoryBlockVisitOutcome): void;
+    close(): void;
+    /** Activates recording for the shared Story execution phase. */
+    activate(): void;
+    /** Deactivates recording outside the shared Story execution phase. */
+    deactivate(): void;
+    execution(): ExecutionPath;
+    private interrupt;
+    private offset;
+}
+export type { ExecutionItem, ExecutionPath, StoryArtifact } from './types.js';
+export declare function roundMillis(value: number): number;
+//# sourceMappingURL=artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/story/artifact/artifact.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,aAAa,EAEb,UAAU,EACV,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,UAAU,YAAY;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED,KAAK,oBAAoB,GACrB,YAAY,GACZ;IAAE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,CAAA;CAAE,CAAC;AAEpD,UAAU,SAAS;IACjB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,CAAA;KAAE,GAAG,SAAS,CAAC;CACvE;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AASD,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,YAA6B,OAAO,EAAE,MAAM,EAAI;IAEhD,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAyBvC;IAED,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAc7D;IAED,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAgB/C;CACF;AAED,qBAAa,gBAAiB,YAAW,aAAa;IAMxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB,YAA6B,MAAM,EAAE,kBAAkB,EAAI;IAE3D,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAG7D;IAED,KAAK,CACH,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,MAAM,EAAE,OAAO,GACd,UAAU,CAuBZ;IAED,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAU5D;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,gEAAgE;IAChE,QAAQ,IAAI,IAAI,CAEf;IAED,sEAAsE;IACtE,UAAU,IAAI,IAAI,CAEjB;IAED,SAAS,IAAI,aAAa,CAEzB;IAED,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,MAAM;CAGf;AAED,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/story/artifact/artifact.js

@@ -0,0 +1,234 @@
+import { realpathSync } from 'node:fs';
+import { relative, sep } from 'node:path';
+const closedVisitToken = Symbol('closed-story-visit');
+export class StoryBlockRegistry {
+    baseDir;
+    blocks = new Map();
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    declare(block) {
+        const location = normalizeLocation(this.baseDir, block);
+        const id = `${location.file}:${location.line}:${location.column}`;
+        const existing = this.blocks.get(id);
+        if (existing !== undefined) {
+            if (existing.block.name !== block.name ||
+                existing.block.kind !== block.kind ||
+                existing.block.description !== block.description) {
+                throw new Error(`Conflicting Story Block declarations at ${id}`);
+            }
+            return id;
+        }
+        const common = {
+            name: block.name,
+            description: block.description,
+            location,
+        };
+        const storyBlock = block.kind === 'decision'
+            ? { ...common, kind: 'decision', arms: [] }
+            : { ...common, kind: 'block' };
+        this.blocks.set(id, { block: storyBlock, arms: new Map() });
+        return id;
+    }
+    declareArm(block, arm) {
+        const id = this.declare(block);
+        const registered = this.blocks.get(id);
+        if (registered?.block.kind !== 'decision') {
+            throw new Error(`Block "${block.name}" cannot declare Decision Arms`);
+        }
+        const key = armKey(arm);
+        const existing = registered.arms.get(key);
+        if (existing !== undefined && !sameArm(existing, arm)) {
+            throw new Error(`Conflicting metadata for Arm "${arm.name}" on Decision "${block.name}"`);
+        }
+        registered.arms.set(key, arm);
+    }
+    toRecord() {
+        return Object.fromEntries([...this.blocks.entries()]
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([id, registered]) => [
+            id,
+            registered.block.kind === 'decision'
+                ? {
+                    ...registered.block,
+                    arms: [...registered.arms.values()].sort((left, right) => armKey(left).localeCompare(armKey(right))),
+                }
+                : registered.block,
+        ]));
+    }
+}
+export class ScenarioRecorder {
+    blocks;
+    root = makeContainer([]);
+    anchor = performance.now();
+    closed = false;
+    active = false;
+    constructor(blocks) {
+        this.blocks = blocks;
+    }
+    declareArm(block, arm) {
+        if (this.closed || !this.active)
+            return;
+        this.blocks.declareArm(block, arm);
+    }
+    start(block, selectedArm, attributes, parent) {
+        if (this.closed || !this.active)
+            return closedVisitToken;
+        const parentToken = isVisitToken(parent) ? parent : undefined;
+        const container = parentToken?.children ?? this.root;
+        const visit = {
+            blockId: this.blocks.declare(block),
+            outcome: 'succeeded',
+            startOffsetMillis: this.offset(),
+            durationMillis: 0,
+            ...(selectedArm === undefined ? {} : { selectedArm }),
+            ...(attributes === undefined
+                ? {}
+                : { attributes: serializeAttributes(block, attributes) }),
+            children: [],
+        };
+        const token = {
+            visit,
+            container,
+            children: makeContainer(visit.children),
+        };
+        appendVisit(container, token);
+        return token;
+    }
+    finish(token, outcome) {
+        if (this.closed || token === closedVisitToken)
+            return;
+        if (!isVisitToken(token))
+            throw new Error('Invalid Story Block Visit token');
+        token.visit.outcome = outcome;
+        token.visit.durationMillis = roundMillis(this.offset() - token.visit.startOffsetMillis);
+        token.container.active.delete(token);
+        if (token.container.active.size === 0)
+            token.container.parallel = undefined;
+    }
+    close() {
+        for (const token of this.root.active)
+            this.interrupt(token);
+        this.closed = true;
+    }
+    /** Activates recording for the shared Story execution phase. */
+    activate() {
+        if (!this.closed)
+            this.active = true;
+    }
+    /** Deactivates recording outside the shared Story execution phase. */
+    deactivate() {
+        this.active = false;
+    }
+    execution() {
+        return normalizePath(this.root.items);
+    }
+    interrupt(token) {
+        token.visit.outcome = 'interrupted';
+        token.visit.durationMillis = roundMillis(this.offset() - token.visit.startOffsetMillis);
+        for (const child of token.children.active)
+            this.interrupt(child);
+    }
+    offset() {
+        return roundMillis(performance.now() - this.anchor);
+    }
+}
+export function roundMillis(value) {
+    return Math.round(value * 1000) / 1000;
+}
+function makeContainer(items) {
+    return { items, active: new Set(), parallel: undefined };
+}
+function appendVisit(container, token) {
+    if (container.active.size === 0) {
+        container.items.push(token.visit);
+    }
+    else if (container.parallel === undefined) {
+        const prior = [...container.active][0];
+        if (prior === undefined)
+            throw new Error('Invalid active Story Visit state');
+        const priorIndex = container.items.lastIndexOf(prior.visit);
+        if (priorIndex < 0) {
+            throw new Error('Ambiguous concurrent Story Block structure');
+        }
+        const parallel = { parallel: [[prior.visit], [token.visit]] };
+        container.items.splice(priorIndex, 1, parallel);
+        container.parallel = parallel;
+    }
+    else {
+        container.parallel.parallel.push([token.visit]);
+    }
+    container.active.add(token);
+}
+function normalizePath(items) {
+    const normalized = [];
+    for (const item of items) {
+        if ('parallel' in item) {
+            const branches = item.parallel
+                .map(normalizePath)
+                .filter((branch) => branch.length > 0)
+                .sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)));
+            if (branches.length === 1)
+                normalized.push(...branches[0]);
+            else if (branches.length > 1)
+                normalized.push({ parallel: branches });
+            continue;
+        }
+        normalized.push({
+            blockId: item.blockId,
+            outcome: item.outcome,
+            startOffsetMillis: item.startOffsetMillis,
+            durationMillis: item.durationMillis,
+            ...(item.selectedArm === undefined
+                ? {}
+                : { selectedArm: item.selectedArm }),
+            ...(item.attributes === undefined ? {} : { attributes: item.attributes }),
+            children: normalizePath(item.children),
+        });
+    }
+    return normalized;
+}
+function normalizeLocation(baseDir, block) {
+    const file = block.location.file.startsWith('/')
+        ? relative(realpathSync(baseDir), realpathSync(block.location.file))
+        : block.location.file;
+    return {
+        file: file.split(sep).join('/'),
+        line: block.location.line,
+        column: block.location.column,
+    };
+}
+function armKey(arm) {
+    return arm.kind === 'otherwise'
+        ? 'otherwise'
+        : `literal:${typeof arm.value}:${JSON.stringify(arm.value)}`;
+}
+function sameArm(left, right) {
+    return (left.kind === right.kind &&
+        left.name === right.name &&
+        left.description === right.description &&
+        (left.kind === 'otherwise' ||
+            (right.kind === 'literal' && Object.is(left.value, right.value))));
+}
+function serializeAttributes(block, attributes) {
+    try {
+        const json = JSON.stringify(attributes);
+        if (json === undefined)
+            throw new TypeError('value serialized to undefined');
+        const value = JSON.parse(json);
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            throw new TypeError('value did not serialize to an object');
+        }
+        return value;
+    }
+    catch (cause) {
+        throw new Error(`Attributes for Story Block "${block.name}" at ${block.location.file}:${block.location.line}:${block.location.column} are not JSON-serializable`, { cause });
+    }
+}
+function isVisitToken(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'visit' in value &&
+        'container' in value &&
+        'children' in value);
+}

package/dist/story/artifact/index.d.ts

@@ -0,0 +1,2 @@
+export { roundMillis, ScenarioRecorder, StoryBlockRegistry, } from './artifact.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/story/artifact/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/story/artifact/index.js

@@ -0,0 +1 @@
+export { roundMillis, ScenarioRecorder, StoryBlockRegistry, } from './artifact.js';

package/dist/story/artifact/storage.d.ts

@@ -0,0 +1,10 @@
+import type { StoryArtifact, StoryIndex } from './types.js';
+export declare function writeRawArtifact(baseDir: string, storyId: string, artifact: StoryArtifact): Promise<void>;
+export declare function clearRawArtifacts(baseDir: string): Promise<void>;
+export declare function commitRawArtifacts(baseDir: string, complete: boolean): Promise<{
+    readonly index: StoryIndex;
+    readonly committedStoryIds: ReadonlySet<string>;
+}>;
+export declare function getStoryIndex(baseDir: string): Promise<StoryIndex>;
+export declare function getStoryArtifact(baseDir: string, storyId: string): Promise<StoryArtifact>;
+//# sourceMappingURL=storage.d.ts.map