laymos 0.0.9 → 0.0.11

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

@@ -1 +1 @@
-{"version":3,"file":"load-changes.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-changes/load-changes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE1E,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,SAAS,GACf,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAKpC;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,SAAS,GACf,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAKnC;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC,CAK5C"}
+{"version":3,"file":"load-changes.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-changes/load-changes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAI1E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,SAAS,GACf,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAKpC;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,SAAS,GACf,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAKnC;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC,CAK5C;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC,CAK5C"}

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

@@ -1,24 +1,29 @@
-import { dirname, resolve } from 'node:path';
+import { resolve } from 'node:path';
 import { Effect } from 'effect';
 import { Git, GitLive } from '../../services/git/index.js';
-export function loadChangeSet(configPath, baseRef = 'HEAD') {
+// Each loader works on any folder inside a git repository; paths are relative
+// to that folder.
+export function loadChangeSet(folder, baseRef = 'HEAD') {
     return Effect.gen(function* () {
         const git = yield* Git;
-        return yield* git.changeSet(projectDir(configPath), baseRef);
+        return yield* git.changeSet(resolve(folder), baseRef);
     }).pipe(Effect.provide(GitLive));
 }
-export function loadFileDiff(configPath, path, baseRef = 'HEAD') {
+export function loadFileDiff(folder, path, baseRef = 'HEAD') {
     return Effect.gen(function* () {
         const git = yield* Git;
-        return yield* git.fileDiff(projectDir(configPath), baseRef, path);
+        return yield* git.fileDiff(resolve(folder), baseRef, path);
     }).pipe(Effect.provide(GitLive));
 }
-export function loadBranches(configPath) {
+export function loadBranches(folder) {
     return Effect.gen(function* () {
         const git = yield* Git;
-        return yield* git.branches(projectDir(configPath));
+        return yield* git.branches(resolve(folder));
     }).pipe(Effect.provide(GitLive));
 }
-function projectDir(configPath) {
-    return dirname(resolve(configPath));
+export function loadKnownFiles(folder) {
+    return Effect.gen(function* () {
+        const git = yield* Git;
+        return yield* git.knownFiles(resolve(folder));
+    }).pipe(Effect.provide(GitLive));
 }

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-source-files/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

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

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

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

@@ -2,15 +2,31 @@ 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.
+ * Reads every 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.
+ * Files git knows beside the analyzed ones are read too, marked as Unanalyzed
+ * files; without git, only analyzed files are read. Only paths inside the Project are ever listed, so a caller can never
+ * use this to read a file outside it.
  */
 export declare function loadSourceFiles(configPath: string, pathPrefixes: readonly string[]): Effect.Effect<{
     files: {
         readonly path: string;
         readonly content: string;
+        readonly binary?: boolean | undefined;
+        readonly unanalyzed?: boolean | undefined;
     }[];
 }, import("../../services/config/errors.js").ConfigError | import("../../services/file-cruiser/errors.js").CruiseError | SourceFileReadError, never>;
+/**
+ * Reads every file git knows at or below one of the given paths of a folder,
+ * such as a Package's files within its Monorepo. Paths are relative to the
+ * folder, and only paths inside it are ever listed.
+ */
+export declare function loadFolderFiles(folder: string, pathPrefixes: readonly string[]): Effect.Effect<{
+    files: {
+        readonly path: string;
+        readonly content: string;
+        readonly binary?: boolean | undefined;
+        readonly unanalyzed?: boolean | undefined;
+    }[];
+}, import("../../services/git/errors.js").GitError | SourceFileReadError, never>;
 //# sourceMappingURL=load-source-files.d.ts.map

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

@@ -1 +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"}
+{"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;AAO5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,MAAM,EAAE;;;;;;;qJAuBhC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,SAAS,MAAM,EAAE;;;;;;;iFAUhC"}

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

@@ -3,28 +3,67 @@ 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 { Git, GitLive } from '../../services/git/index.js';
 import { loadProject } from '../load-project/index.js';
 import { SourceFileReadError } from './errors.js';
 export { SourceFileReadError } from './errors.js';
+// Git's own test for binary content: a NUL byte near the start.
+const binarySniffLength = 8000;
 /**
- * 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.
+ * Reads every 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.
+ * Files git knows beside the analyzed ones are read too, marked as Unanalyzed
+ * files; without git, only analyzed files are read. Only paths inside the Project are ever listed, so a caller can never
+ * use this to read a file outside it.
  */
 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()]
+        const known = yield* knownFiles(baseDir).pipe(Effect.orElseSucceed(() => []));
+        const paths = [...new Set([...fileGraph.keys(), ...known])]
             .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 }))));
+        const files = yield* readFiles(baseDir, paths, (path) => fileGraph.has(path));
         return { files };
     }).pipe(Effect.provide(ConfigServiceLive), Effect.provide(CruiserLive), Effect.provide(NodeServices.layer));
 }
+/**
+ * Reads every file git knows at or below one of the given paths of a folder,
+ * such as a Package's files within its Monorepo. Paths are relative to the
+ * folder, and only paths inside it are ever listed.
+ */
+export function loadFolderFiles(folder, pathPrefixes) {
+    const baseDir = resolve(folder);
+    return Effect.gen(function* () {
+        const paths = (yield* knownFiles(baseDir)).filter((path) => underAnyPrefix(path, pathPrefixes));
+        const files = yield* readFiles(baseDir, paths, () => true);
+        return { files };
+    }).pipe(Effect.provide(NodeServices.layer));
+}
+function knownFiles(baseDir) {
+    return Effect.gen(function* () {
+        const git = yield* Git;
+        return yield* git.knownFiles(baseDir);
+    }).pipe(Effect.provide(GitLive));
+}
+function readFiles(baseDir, paths, isAnalyzed) {
+    return Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const files = yield* Effect.forEach(paths, (path) => fileSystem.readFile(resolve(baseDir, path)).pipe(Effect.map((bytes) => sourceFile(path, bytes, isAnalyzed(path))), Effect.mapError((cause) => new SourceFileReadError({ filePath: path, cause }))));
+        return files;
+    });
+}
+function sourceFile(path, bytes, analyzed) {
+    const binary = bytes.subarray(0, binarySniffLength).includes(0);
+    return {
+        path,
+        content: binary ? '' : new TextDecoder().decode(bytes),
+        ...(binary ? { binary } : {}),
+        ...(analyzed ? {} : { unanalyzed: true }),
+    };
+}
 function underAnyPrefix(path, pathPrefixes) {
     return pathPrefixes.some((prefix) => prefix === '.' || path === prefix || path.startsWith(`${prefix}/`));
 }

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

@@ -2,4 +2,5 @@ import type { Branch, ChangeSet, DiffHunk } from '../../change-set-schema/index.
 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[]>;
+export declare function listKnownFiles(baseDir: string): Promise<string[]>;
 //# 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,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"}
+{"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;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBvE"}

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

@@ -80,6 +80,14 @@ export async function listBranches(baseDir) {
         .map((name) => ({ name, remote: true, current: false }));
     return [...local, ...remote];
 }
+export async function listKnownFiles(baseDir) {
+    await requireGit(baseDir, ['rev-parse', '--show-toplevel'], 'not-a-repo');
+    const known = splitNul(await requireGit(baseDir, ['ls-files', '--cached', '--others', '--exclude-standard', '-z'], 'command-failed'));
+    const deleted = new Set(splitNul(await requireGit(baseDir, ['ls-files', '--deleted', '-z'], 'command-failed')));
+    return [...new Set(known)]
+        .filter((path) => !deleted.has(path))
+        .sort((left, right) => left.localeCompare(right));
+}
 function splitLines(stdout) {
     return stdout
         .split('\n')

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

@@ -5,6 +5,7 @@ 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>;
+    readonly knownFiles: (baseDir: string) => Effect.Effect<readonly string[], 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,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"}
+{"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;AAO1C,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;yBAG1B,CACnB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC;;AAnBnD,qBAAa,GAAI,SAAQ,QAqBf;CAAG;AAEb,eAAO,MAAM,OAAO,gCAwBlB,CAAC"}

package/dist/services/git/git.js

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

package/dist/skills-command/index.d.ts

@@ -0,0 +1,2 @@
+export { makeSkillsCommand, type SkillsCommandOptions, } from './skills-command.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills-command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills-command/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC"}

package/dist/skills-command/index.js

@@ -0,0 +1 @@
+export { makeSkillsCommand, } from './skills-command.js';

package/dist/skills-command/skills-command.d.ts

@@ -0,0 +1,21 @@
+import { FileSystem } from 'effect';
+import { Command } from 'effect/unstable/cli';
+export type SkillsCommandOptions = {
+    /** Folder holding one sub-folder per skill, each with a `SKILL.md`. */
+    readonly skillsRoot: string;
+    /** Skill folder names in listing order. */
+    readonly names: ReadonlyArray<string>;
+    /** The CLI's own name, used in help text. */
+    readonly cliName: string;
+};
+/**
+ * Builds a `skills` subcommand: `skills` lists, `skills <name>` prints one
+ * SKILL.md, and `--install <dir>` copies one or every skill folder into
+ * `<dir>/<name>/`, overwriting what is there.
+ */
+export declare const makeSkillsCommand: ({ skillsRoot, names, cliName, }: SkillsCommandOptions) => Command.Command<"skills", {
+    readonly name: import("effect/Option").Option<string>;
+    readonly install: import("effect/Option").Option<string>;
+    readonly format: "json" | "text";
+}, {}, import("effect/PlatformError").PlatformError, FileSystem.FileSystem>;
+//# sourceMappingURL=skills-command.d.ts.map

package/dist/skills-command/skills-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-command.d.ts","sourceRoot":"","sources":["../../src/skills-command/skills-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,UAAU,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAY,OAAO,EAAQ,MAAM,qBAAqB,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAoCF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAI3B,oBAAoB;;;;2EAwEtB,CAAC"}

package/dist/skills-command/skills-command.js

@@ -0,0 +1,64 @@
+import path from 'node:path';
+import { Console, Effect, FileSystem } from 'effect';
+import { Argument, Command, Flag } from 'effect/unstable/cli';
+const descriptionOf = (markdown) => /^description:\s*(.+)$/m.exec(markdown)?.[1]?.trim() ?? '';
+const renderList = (skills) => skills.map((skill) => `${skill.name}  ${skill.description}`).join('\n');
+const fail = (message) => Console.error(message).pipe(Effect.andThen(Effect.sync(() => {
+    process.exitCode = 1;
+})));
+const nameArgument = Argument.string('name').pipe(Argument.withDescription('Skill to print or install; omit for all skills'), Argument.optional);
+const installFlag = Flag.directory('install', { mustExist: false }).pipe(Flag.withDescription('Copy the skill folder(s) into <dir>/<name>/ instead of printing'), Flag.optional);
+const formatFlag = Flag.choice('format', ['json', 'text']).pipe(Flag.withDescription('List skills as readable text or JSON'), Flag.withDefault('text'));
+/**
+ * Builds a `skills` subcommand: `skills` lists, `skills <name>` prints one
+ * SKILL.md, and `--install <dir>` copies one or every skill folder into
+ * `<dir>/<name>/`, overwriting what is there.
+ */
+export const makeSkillsCommand = ({ skillsRoot, names, cliName, }) => {
+    const skillDir = (name) => path.join(skillsRoot, name);
+    const summarize = (name) => Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        const markdown = yield* fs.readFileString(path.join(skillDir(name), 'SKILL.md'));
+        return { name, description: descriptionOf(markdown), markdown };
+    });
+    const printSkill = (name) => Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        const { markdown } = yield* summarize(name);
+        yield* Console.log(markdown.trimEnd());
+        const files = yield* fs.readDirectory(skillDir(name), {
+            recursive: true,
+        });
+        const extra = files.filter((file) => file !== 'SKILL.md').length;
+        if (extra > 0) {
+            yield* Console.error(`Note: ${name} ships ${extra} more file(s). Use --install <dir> to get all of them.`);
+        }
+    });
+    const installSkills = (selected, directory) => Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        const root = path.resolve(directory);
+        yield* fs.makeDirectory(root, { recursive: true });
+        for (const name of selected) {
+            const target = path.join(root, name);
+            yield* fs.copy(skillDir(name), target, { overwrite: true });
+            yield* Console.log(`Installed skill ${name} at ${target}`);
+        }
+    });
+    return Command.make('skills', { name: nameArgument, install: installFlag, format: formatFlag }, ({ name, install, format }) => Effect.gen(function* () {
+        if (name._tag === 'Some' && !names.includes(name.value)) {
+            return yield* fail(`Unknown skill: ${name.value}. Available: ${names.join(', ')}`);
+        }
+        const selected = name._tag === 'Some' ? [name.value] : names;
+        if (install._tag === 'Some') {
+            return yield* installSkills(selected, install.value);
+        }
+        if (name._tag === 'Some')
+            return yield* printSkill(name.value);
+        const skills = yield* Effect.forEach(names, (skill) => Effect.map(summarize(skill), ({ name, description }) => ({
+            name,
+            description,
+        })));
+        yield* Console.log(format === 'json'
+            ? JSON.stringify(skills, null, 2)
+            : renderList(skills));
+    })).pipe(Command.withDescription(`List the agent skills shipped with ${cliName}, print one, or install them into a skills folder`));
+};

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

@@ -1,5 +1,5 @@
-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 { CapturedTraceSchema, QuestionReportSchema, QuestionSectionSchema, JournalSchema, StoryAssertionSchema, StoryReportSchema, StoryVerdictSchema, } from './story-report-schema.js';
+export type { CapturedTrace, JsonValue, QuestionReport, QuestionSection, Journal, StoryAssertion, StoryReport, StoryVerdict, } from './story-report-schema.js';
 export { slugifyQuestion } from './slug.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';

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/story/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,OAAO,EACP,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 { CapturedTraceSchema, QuestionReportSchema, QuestionSectionSchema, JournalSchema, StoryAssertionSchema, StoryReportSchema, StoryVerdictSchema, } from './story-report-schema.js';
 export { slugifyQuestion } from './slug.js';
 export { QuestionLeafSchema, StoryLeafSchema, StoryPageSchema, StorySourceSchema, StoryTreeGroupSchema, StoryTreeSchema, } from './story-tree-schema.js';