@llm4ts/runner 0.4.0 → 0.6.0

package/dist/Packs.d.ts

@@ -0,0 +1,54 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { PlanParseError } from "@llm4ts/flow/FlowError";
+import { type Pack } from "@llm4ts/flow/Pack";
+import { type PatternCard } from "@llm4ts/flow/Patterns";
+import type { WorkspaceError, WorkspaceShape } from "@llm4ts/flow/Workspace";
+declare const PackNotFound_base: Schema.Class<PackNotFound, Schema.TaggedStruct<"PackNotFound", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Pack location for the modernization flows. `LLM4TS_PACK` names the pack
+ * (default `packs/cobol-springboot`) and is resolved against the launch
+ * directory first — a pack the user keeps next to their work wins — then
+ * against the flow script's own directory, where the published shell ships
+ * the built-in packs. An absolute `LLM4TS_PACK` is used as-is. The fallback
+ * is what lets `llm4ts run modernize-survey --repo <estate>` work from any
+ * directory instead of only from a checkout with `packs/` at its cwd.
+ */
+export declare class PackNotFound extends PackNotFound_base {
+}
+export interface LocatedPack {
+    /** Directory the pack workspace is rooted at. */
+    readonly root: string;
+    /** Pack directory relative to `root` (`"."` when the pack path is absolute). */
+    readonly dir: string;
+}
+/** The first candidate root whose `packDir` holds a `pack.md` manifest. */
+export declare const locatePack: (packDir: string, roots: ReadonlyArray<string>) => LocatedPack | undefined;
+export interface OpenedPack {
+    readonly pack: Pack;
+    /**
+     * Workspace rooted where the pack was found. Pack-relative paths — prompts,
+     * `<pack>/patterns`, `lessons.md`, the scaffold — must resolve through this
+     * workspace, not the launch directory's.
+     */
+    readonly workspace: WorkspaceShape;
+    /** Pack directory within `workspace`. */
+    readonly dir: string;
+}
+export declare const openPack: (options: {
+    readonly environment: Readonly<Record<string, string | undefined>>;
+    /** The directory the flow was launched from (`resolveFlowInput().workspace`). */
+    readonly launchDir: string;
+    /** The directory holding the flow script (`import.meta.dirname`). */
+    readonly flowDir: string;
+}) => Effect.Effect<OpenedPack, PlanParseError | WorkspaceError | PackNotFound, never>;
+/**
+ * The universal pattern cards: the first candidate root with a `patterns/`
+ * directory contributes them, and no root having one is an empty set —
+ * patterns are optional everywhere.
+ */
+export declare const loadUniversalPatternCards: (roots: readonly string[]) => Effect.Effect<readonly PatternCard[], WorkspaceError, never>;
+export {};
+//# sourceMappingURL=Packs.d.ts.map

package/dist/Packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Packs.d.ts","sourceRoot":"","sources":["../src/Packs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;;;;AAG5E;;;;;;;;GAQG;AAEH,qBAAa,YAAa,SAAQ,iBAEhC;CAAG;AAEL,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,2EAA2E;AAC3E,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAO,aAAa,CAAC,MAAM,CAAC,KAC3B,WAAW,GAAG,SAWhB,CAAA;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,eAAO,MAAM,QAAQ;0BACG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClE,iFAAiF;wBAC7D,MAAM;IAC1B,qEAAqE;sBACnD,MAAM;sFAexB,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,4FAapC,CAAA"}

package/dist/Packs.js

@@ -0,0 +1,63 @@
+import { existsSync } from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { loadPack } from "@llm4ts/flow/Pack";
+import { loadPatternCards } from "@llm4ts/flow/Patterns";
+import { makeNodeWorkspace } from "./NodeWorkspace.js";
+/**
+ * Pack location for the modernization flows. `LLM4TS_PACK` names the pack
+ * (default `packs/cobol-springboot`) and is resolved against the launch
+ * directory first — a pack the user keeps next to their work wins — then
+ * against the flow script's own directory, where the published shell ships
+ * the built-in packs. An absolute `LLM4TS_PACK` is used as-is. The fallback
+ * is what lets `llm4ts run modernize-survey --repo <estate>` work from any
+ * directory instead of only from a checkout with `packs/` at its cwd.
+ */
+export class PackNotFound extends Schema.TaggedErrorClass()("PackNotFound", {
+    message: Schema.String
+}) {
+}
+/** The first candidate root whose `packDir` holds a `pack.md` manifest. */
+export const locatePack = (packDir, roots) => {
+    if (isAbsolute(packDir)) {
+        return existsSync(join(packDir, "pack.md")) ? { root: packDir, dir: "." } : undefined;
+    }
+    for (const root of roots) {
+        const resolved = resolve(root);
+        if (existsSync(join(resolved, packDir, "pack.md"))) {
+            return { root: resolved, dir: packDir };
+        }
+    }
+    return undefined;
+};
+export const openPack = Effect.fn("@llm4ts/runner/Packs.openPack")(function* (options) {
+    const packDir = options.environment.LLM4TS_PACK ?? "packs/cobol-springboot";
+    const located = locatePack(packDir, [options.launchDir, options.flowDir]);
+    if (located === undefined) {
+        return yield* PackNotFound.make({
+            message: `pack '${packDir}' not found: no ${join(packDir, "pack.md")} under ` +
+                `${resolve(options.launchDir)} or ${resolve(options.flowDir)} — ` +
+                "set LLM4TS_PACK or launch from a directory containing the pack"
+        });
+    }
+    const workspace = yield* makeNodeWorkspace(located.root);
+    const pack = yield* loadPack(workspace, located.dir);
+    return { pack, workspace, dir: located.dir };
+});
+/**
+ * The universal pattern cards: the first candidate root with a `patterns/`
+ * directory contributes them, and no root having one is an empty set —
+ * patterns are optional everywhere.
+ */
+export const loadUniversalPatternCards = Effect.fn("@llm4ts/runner/Packs.loadUniversalPatternCards")(function* (roots) {
+    const root = roots
+        .map((candidate) => resolve(candidate))
+        .find((candidate) => existsSync(join(candidate, "patterns")));
+    if (root === undefined) {
+        return [];
+    }
+    const workspace = yield* makeNodeWorkspace(root);
+    return yield* loadPatternCards(workspace, "patterns");
+});
+//# sourceMappingURL=Packs.js.map

package/dist/Packs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm4ts/runner",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Node runner, CLI, terminal, and MCP composition for llm4ts",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,7 @@
     "./NodeTemporaryFiles": "./dist/NodeTemporaryFiles.js",
     "./NodeWorkspace": "./dist/NodeWorkspace.js",
     "./NodeRuntime": "./dist/NodeRuntime.js",
+    "./Packs": "./dist/Packs.js",
     "./ReviewFingerprint": "./dist/ReviewFingerprint.js",
     "./Terminal": "./dist/Terminal.js",
     "./TerminalInteraction": "./dist/TerminalInteraction.js",
@@ -55,8 +56,8 @@
     "typescript"
   ],
   "dependencies": {
-    "@llm4ts/core": "0.4.0",
-    "@llm4ts/flow": "0.4.0"
+    "@llm4ts/flow": "0.6.0",
+    "@llm4ts/core": "0.6.0"
   },
   "peerDependencies": {
     "effect": "^4.0.0-beta.102"

package/src/Packs.ts

@@ -0,0 +1,101 @@
+import { existsSync } from "node:fs"
+import { isAbsolute, join, resolve } from "node:path"
+import * as Effect from "effect/Effect"
+import * as Schema from "effect/Schema"
+import type { PlanParseError } from "@llm4ts/flow/FlowError"
+import { loadPack, type Pack } from "@llm4ts/flow/Pack"
+import { loadPatternCards, type PatternCard } from "@llm4ts/flow/Patterns"
+import type { WorkspaceError, WorkspaceShape } from "@llm4ts/flow/Workspace"
+import { makeNodeWorkspace } from "./NodeWorkspace.ts"
+
+/**
+ * Pack location for the modernization flows. `LLM4TS_PACK` names the pack
+ * (default `packs/cobol-springboot`) and is resolved against the launch
+ * directory first — a pack the user keeps next to their work wins — then
+ * against the flow script's own directory, where the published shell ships
+ * the built-in packs. An absolute `LLM4TS_PACK` is used as-is. The fallback
+ * is what lets `llm4ts run modernize-survey --repo <estate>` work from any
+ * directory instead of only from a checkout with `packs/` at its cwd.
+ */
+
+export class PackNotFound extends Schema.TaggedErrorClass<PackNotFound>()("PackNotFound", {
+  message: Schema.String
+}) {}
+
+export interface LocatedPack {
+  /** Directory the pack workspace is rooted at. */
+  readonly root: string
+  /** Pack directory relative to `root` (`"."` when the pack path is absolute). */
+  readonly dir: string
+}
+
+/** The first candidate root whose `packDir` holds a `pack.md` manifest. */
+export const locatePack = (
+  packDir: string,
+  roots: ReadonlyArray<string>
+): LocatedPack | undefined => {
+  if (isAbsolute(packDir)) {
+    return existsSync(join(packDir, "pack.md")) ? { root: packDir, dir: "." } : undefined
+  }
+  for (const root of roots) {
+    const resolved = resolve(root)
+    if (existsSync(join(resolved, packDir, "pack.md"))) {
+      return { root: resolved, dir: packDir }
+    }
+  }
+  return undefined
+}
+
+export interface OpenedPack {
+  readonly pack: Pack
+  /**
+   * Workspace rooted where the pack was found. Pack-relative paths — prompts,
+   * `<pack>/patterns`, `lessons.md`, the scaffold — must resolve through this
+   * workspace, not the launch directory's.
+   */
+  readonly workspace: WorkspaceShape
+  /** Pack directory within `workspace`. */
+  readonly dir: string
+}
+
+export const openPack = Effect.fn("@llm4ts/runner/Packs.openPack")(function* (options: {
+  readonly environment: Readonly<Record<string, string | undefined>>
+  /** The directory the flow was launched from (`resolveFlowInput().workspace`). */
+  readonly launchDir: string
+  /** The directory holding the flow script (`import.meta.dirname`). */
+  readonly flowDir: string
+}): Effect.fn.Return<OpenedPack, PackNotFound | WorkspaceError | PlanParseError> {
+  const packDir = options.environment.LLM4TS_PACK ?? "packs/cobol-springboot"
+  const located = locatePack(packDir, [options.launchDir, options.flowDir])
+  if (located === undefined) {
+    return yield* PackNotFound.make({
+      message:
+        `pack '${packDir}' not found: no ${join(packDir, "pack.md")} under ` +
+        `${resolve(options.launchDir)} or ${resolve(options.flowDir)} — ` +
+        "set LLM4TS_PACK or launch from a directory containing the pack"
+    })
+  }
+  const workspace = yield* makeNodeWorkspace(located.root)
+  const pack = yield* loadPack(workspace, located.dir)
+  return { pack, workspace, dir: located.dir }
+})
+
+/**
+ * The universal pattern cards: the first candidate root with a `patterns/`
+ * directory contributes them, and no root having one is an empty set —
+ * patterns are optional everywhere.
+ */
+export const loadUniversalPatternCards = Effect.fn(
+  "@llm4ts/runner/Packs.loadUniversalPatternCards"
+)(function* (
+  roots: ReadonlyArray<string>
+): Effect.fn.Return<ReadonlyArray<PatternCard>, WorkspaceError> {
+  const root = roots
+    .map((candidate) => resolve(candidate))
+    .find((candidate) => existsSync(join(candidate, "patterns")))
+  if (root === undefined) {
+    return []
+  }
+  const workspace = yield* makeNodeWorkspace(root)
+  return yield* loadPatternCards(workspace, "patterns")
+})