laymos 0.0.6 → 0.0.8

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/index.d.ts

@@ -1,6 +1,6 @@
 export { CapturedTraceSchema, QuestionReportSchema, QuestionSectionSchema, RecordedFlowSchema, StoryAssertionSchema, StoryReportSchema, StoryVerdictSchema, } from './story-report-schema.js';
 export type { CapturedTrace, JsonValue, QuestionReport, QuestionSection, RecordedFlow, StoryAssertion, StoryReport, StoryVerdict, } from './story-report-schema.js';
 export { slugifyQuestion } from './slug.js';
-export { QuestionLeafSchema, StoryLeafSchema, StorySourceSchema, StoryTreeGroupSchema, StoryTreeSchema, } from './story-tree-schema.js';
-export type { QuestionLeaf, StoryLeaf, StorySource, StoryTree, StoryTreeGroup, } from './story-tree-schema.js';
+export { QuestionLeafSchema, StoryLeafSchema, StoryPageSchema, StorySourceSchema, StoryTreeGroupSchema, StoryTreeSchema, } from './story-tree-schema.js';
+export type { QuestionLeaf, StoryLeaf, StoryPage, StorySource, StoryTree, StoryTreeGroup, } from './story-tree-schema.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/story/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,GACf,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/story/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/dist/story/schema/index.js

@@ -1,4 +1,4 @@
 // RPC transports and renderers use this browser-safe Story report contract.
 export { CapturedTraceSchema, QuestionReportSchema, QuestionSectionSchema, RecordedFlowSchema, StoryAssertionSchema, StoryReportSchema, StoryVerdictSchema, } from './story-report-schema.js';
 export { slugifyQuestion } from './slug.js';
-export { QuestionLeafSchema, StoryLeafSchema, StorySourceSchema, StoryTreeGroupSchema, StoryTreeSchema, } from './story-tree-schema.js';
+export { QuestionLeafSchema, StoryLeafSchema, StoryPageSchema, StorySourceSchema, StoryTreeGroupSchema, StoryTreeSchema, } from './story-tree-schema.js';

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/schema/story-tree-schema.d.ts

@@ -3,6 +3,10 @@ export declare const StorySourceSchema: Schema.Struct<{
     readonly path: Schema.String;
     readonly content: Schema.String;
 }>;
+export declare const StoryPageSchema: Schema.Struct<{
+    readonly path: Schema.String;
+    readonly content: Schema.String;
+}>;
 export declare const QuestionLeafSchema: Schema.Struct<{
     readonly slug: Schema.String;
     readonly question: Schema.String;
@@ -12,6 +16,12 @@ export declare const QuestionLeafSchema: Schema.Struct<{
 export declare const StoryLeafSchema: Schema.Struct<{
     readonly id: Schema.String;
     readonly title: Schema.String;
+    readonly description: Schema.String;
+    readonly spine: Schema.Boolean;
+    readonly page: Schema.NullOr<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly content: Schema.String;
+    }>>;
     readonly setup: Schema.NullOr<Schema.String>;
     readonly questions: Schema.$Array<Schema.Struct<{
         readonly slug: Schema.String;
@@ -30,6 +40,8 @@ export declare const StoryLeafSchema: Schema.Struct<{
 }>;
 export interface StoryTreeGroup {
     readonly title: string;
+    readonly description: string;
+    readonly page: typeof StoryPageSchema.Type | null;
     readonly groups: readonly StoryTreeGroup[];
     readonly stories: readonly (typeof StoryLeafSchema.Type)[];
 }
@@ -38,5 +50,6 @@ export declare const StoryTreeSchema: Schema.Codec<StoryTreeGroup, StoryTreeGrou
 export type QuestionLeaf = typeof QuestionLeafSchema.Type;
 export type StoryLeaf = typeof StoryLeafSchema.Type;
 export type StorySource = typeof StorySourceSchema.Type;
+export type StoryPage = typeof StoryPageSchema.Type;
 export type StoryTree = StoryTreeGroup;
 //# sourceMappingURL=story-tree-schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"story-tree-schema.d.ts","sourceRoot":"","sources":["../../../src/story/schema/story-tree-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,iBAAiB;;;EAO5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;EAS7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAW1B,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;CAC5D;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAUjB,CAAC;AAE9C,eAAO,MAAM,eAAe,4DAI1B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC"}
+{"version":3,"file":"story-tree-schema.d.ts","sourceRoot":"","sources":["../../../src/story/schema/story-tree-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,iBAAiB;;;EAO5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;EAO1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;EAS7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAc1B,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,eAAe,CAAC,IAAI,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;CAC5D;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAYjB,CAAC;AAE9C,eAAO,MAAM,eAAe,4DAI1B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC"}

package/dist/story/schema/story-tree-schema.js

@@ -6,6 +6,13 @@ export const StorySourceSchema = Schema.Struct({
     title: 'Story Source',
     description: 'The full text of a project file backing a Story: the file the Story was authored in, or the support file its proofs import.',
 });
+export const StoryPageSchema = Schema.Struct({
+    path: Schema.String,
+    content: Schema.String,
+}).annotate({
+    title: 'Story Page',
+    description: "The markdown page narrating a Story or a Story Group: a Story's sibling `.md` file, or a Story Group's `index.md`. Null when the author wrote none.",
+});
 export const QuestionLeafSchema = Schema.Struct({
     slug: Schema.String,
     question: Schema.String,
@@ -18,21 +25,26 @@ export const QuestionLeafSchema = Schema.Struct({
 export const StoryLeafSchema = Schema.Struct({
     id: Schema.String,
     title: Schema.String,
+    description: Schema.String,
+    spine: Schema.Boolean,
+    page: Schema.NullOr(StoryPageSchema),
     setup: Schema.NullOr(Schema.String),
     questions: Schema.Array(QuestionLeafSchema),
     source: StorySourceSchema,
     support: Schema.NullOr(StorySourceSchema),
 }).annotate({
     title: 'Story Leaf',
-    description: 'One Story in the Story tree: its derived id, the shared setup snippet, its Questions in authored order, and the support file its proofs import. Never carries results.',
+    description: 'One Story in the Story tree: its derived id, its one-line description, whether it sits on the spine, its markdown page, the shared setup snippet, its Questions in authored order, and the support file its proofs import. Never carries results.',
 });
 export const StoryTreeGroupSchema = Schema.Struct({
     title: Schema.String,
+    description: Schema.String,
+    page: Schema.NullOr(StoryPageSchema),
     groups: Schema.Array(Schema.suspend(() => StoryTreeGroupSchema)),
     stories: Schema.Array(StoryLeafSchema),
 }).annotate({
     title: 'Story Group',
-    description: 'One node of the Story tree: a title over any mix of subgroups and Story leaves.',
+    description: 'One node of the Story tree: a title, a one-line description, its markdown page, over any mix of subgroups and Story leaves.',
 });
 export const StoryTreeSchema = StoryTreeGroupSchema.annotate({
     title: 'Story Tree',

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>;
@@ -13,21 +13,30 @@ export interface StoryQuestion {
 }
 export interface Story {
     readonly title: string;
+    readonly description: string;
+    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;
+    readonly description: string;
     readonly children: readonly StoryNode[];
 }
 export type StoryNode = Story | StoryGroup;
 export declare const Story: {
-    make(story: Story): Story;
+    make(story: Omit<Story, 'spine'> & {
+        readonly spine?: boolean;
+    }): Story;
     question(question: string, options: {
         readonly answer: string;
         readonly proof: Effect.Effect<unknown, unknown, StoryContext>;
     }): StoryQuestion;
-    group(title: string, children: readonly StoryNode[]): StoryGroup;
+    group(title: string, options: {
+        readonly description: string;
+    }, children: readonly StoryNode[]): StoryGroup;
     trace<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R | StoryContext>;
     flow<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R | StoryContext>;
     assert(description: string, passed: boolean): Effect.Effect<void, never, StoryContext>;

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,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,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAE3C,eAAO,MAAM,KAAK;IAChB,IAAI,QAAQ,KAAK,GAAG,KAAK;IAIzB,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,QAAQ,MAAM,YAAY,SAAS,SAAS,EAAE,GAAG,UAAU;IAIhE,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,CActD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOhE"}
+{"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/dist/story/story.js

@@ -4,13 +4,13 @@ export class StoryContext extends Context.Service()('StoryContext') {
 }
 export const Story = {
     make(story) {
-        return story;
+        return { ...story, spine: story.spine ?? false };
     },
     question(question, options) {
         return { question, answer: options.answer, proof: options.proof };
     },
-    group(title, children) {
-        return { title, children };
+    group(title, options, children) {
+        return { title, description: options.description, children };
     },
     trace(effect) {
         return Effect.gen(function* () {
@@ -39,6 +39,8 @@ export function isStory(value) {
         return false;
     const story = value;
     return (typeof story.title === 'string' &&
+        typeof story.description === 'string' &&
+        typeof story.spine === 'boolean' &&
         typeof story.sourceUrl === 'string' &&
         Array.isArray(story.questions) &&
         story.questions.every((question) => typeof question.question === 'string' &&
@@ -49,7 +51,9 @@ export function isStoryGroup(value) {
     if (typeof value !== 'object' || value === null)
         return false;
     const group = value;
-    if (typeof group.title !== 'string' || !Array.isArray(group.children)) {
+    if (typeof group.title !== 'string' ||
+        typeof group.description !== 'string' ||
+        !Array.isArray(group.children)) {
         return false;
     }
     return group.children.every((child) => isStory(child) || isStoryGroup(child));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laymos",
-  "version": "0.0.6",
+  "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.6"
+    "@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": {