@yaag/cli 0.1.0

package/assets/types/typebox/build/value/equal/equal.d.mts

@@ -0,0 +1,2 @@
+/** Returns true if left and right values are structurally equal */
+export declare function Equal(left: unknown, right: unknown): boolean;

package/assets/types/typebox/build/value/equal/index.d.mts

@@ -0,0 +1 @@
+export * from './equal.mjs';

package/assets/types/typebox/build/value/errors/errors.d.mts

@@ -0,0 +1,16 @@
+import type { TProperties, TSchema } from '../../type/index.mjs';
+import type { TLocalizedValidationError } from '../../error/index.mjs';
+/**
+ * Performs an exhaustive Check on the specified value and reports any errors found.
+ * If no errors are found, an empty array is returned. Unlike Check, this function
+ * does not terminate at the first occurrence of an error. For best performance, call
+ * Check first and call Errors only if Check returns false.
+ */
+export declare function Errors<Type extends TSchema>(type: Type, value: unknown): TLocalizedValidationError[];
+/**
+ * Performs an exhaustive Check on the specified value and reports any errors found.
+ * If no errors are found, an empty array is returned. Unlike Check, this function
+ * does not terminate at the first occurrence of an error. For best performance, call
+ * Check first and call Errors only if Check returns false.
+ */
+export declare function Errors<Context extends TProperties, Type extends TSchema>(context: Context, type: Type, value: unknown): TLocalizedValidationError[];

package/assets/types/typebox/build/value/errors/index.d.mts

@@ -0,0 +1 @@
+export * from './errors.mjs';

package/assets/types/typebox/build/value/hash/hash.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Computes a unique 64-bit hash of the specified value and returns the hex string representation. This
+ * function internally uses a non-cryptographic FNV1A64 algorithm for hashing. Hashing is implemented
+ * via structural traversal of the value.
+ */
+export declare function Hash(value: unknown): string;

package/assets/types/typebox/build/value/hash/index.d.mts

@@ -0,0 +1 @@
+export * from './hash.mjs';

package/assets/types/typebox/build/value/index.d.mts

@@ -0,0 +1,20 @@
+export * from './assert/index.mjs';
+export * from './check/index.mjs';
+export * from './clean/index.mjs';
+export * from './clone/index.mjs';
+export * from './codec/index.mjs';
+export * from './convert/index.mjs';
+export * from './create/index.mjs';
+export * from './errors/index.mjs';
+export * from './default/index.mjs';
+export * from './equal/index.mjs';
+export * from './hash/index.mjs';
+export * from './parse/index.mjs';
+export * from './delta/index.mjs';
+export * from './pipeline/index.mjs';
+export * from './pointer/index.mjs';
+export * from './repair/index.mjs';
+export * from './shared/index.mjs';
+import * as Value from './value.mjs';
+export * as Value from './value.mjs';
+export default Value;

package/assets/types/typebox/build/value/parse/index.d.mts

@@ -0,0 +1 @@
+export * from './parse.mjs';

package/assets/types/typebox/build/value/parse/parse.d.mts

@@ -0,0 +1,11 @@
+import { type TLocalizedValidationError } from '../../error/errors.mjs';
+import { type TProperties, type TSchema, type StaticParse } from '../../type/index.mjs';
+import { AssertError } from '../assert/index.mjs';
+export declare class ParseError extends AssertError {
+    constructor(value: unknown, errors: TLocalizedValidationError[]);
+}
+export declare const Parser: import("../pipeline/pipeline.mjs").PipelineInterface;
+/**  Parses a value with the given type. */
+export declare function Parse<const Type extends TSchema>(type: Type, value: unknown): StaticParse<Type>;
+/**  Parses a value with the given type. */
+export declare function Parse<Context extends TProperties, const Type extends TSchema>(context: Context, type: Type, value: unknown): StaticParse<Type, Context>;

package/assets/types/typebox/build/value/pipeline/index.d.mts

@@ -0,0 +1 @@
+export * from './pipeline.mjs';

package/assets/types/typebox/build/value/pipeline/pipeline.d.mts

@@ -0,0 +1,10 @@
+import { type TProperties, type TSchema } from '../../type/index.mjs';
+export interface PipelineFunction {
+    (context: TProperties, schema: TSchema, value: unknown): unknown;
+}
+export interface PipelineInterface {
+    (schema: TSchema, value: unknown): unknown;
+    (context: TProperties, schema: TSchema, value: unknown): unknown;
+}
+/** Creates a value processing pipeline. */
+export declare function Pipeline(pipeline: PipelineFunction[]): PipelineInterface;

package/assets/types/typebox/build/value/pointer/index.d.mts

@@ -0,0 +1 @@
+export * from '../../schema/pointer/index.mjs';

package/assets/types/typebox/build/value/repair/error.d.mts

@@ -0,0 +1,7 @@
+import type { TProperties, TSchema } from '../../type/index.mjs';
+export declare class RepairError extends Error {
+    readonly context: TProperties;
+    readonly type: TSchema;
+    readonly value: unknown;
+    constructor(context: TProperties, type: TSchema, value: unknown, message: string);
+}

package/assets/types/typebox/build/value/repair/from_array.d.mts

@@ -0,0 +1,2 @@
+import type { TProperties, TArray } from '../../type/index.mjs';
+export declare function FromArray(context: TProperties, type: TArray, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_enum.d.mts

@@ -0,0 +1,2 @@
+import { type TProperties, type TEnum } from '../../type/index.mjs';
+export declare function FromEnum(context: TProperties, type: TEnum, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_intersect.d.mts

@@ -0,0 +1,2 @@
+import { type TProperties, type TIntersect } from '../../type/index.mjs';
+export declare function FromIntersect(context: TProperties, type: TIntersect, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_object.d.mts

@@ -0,0 +1,2 @@
+import type { TProperties, TObject } from '../../type/index.mjs';
+export declare function FromObject(context: TProperties, type: TObject, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_record.d.mts

@@ -0,0 +1,2 @@
+import { type TProperties, type TRecord } from '../../type/index.mjs';
+export declare function FromRecord(context: TProperties, type: TRecord, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_ref.d.mts

@@ -0,0 +1,2 @@
+import type { TProperties, TRef } from '../../type/index.mjs';
+export declare function FromRef(context: TProperties, type: TRef, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_template_literal.d.mts

@@ -0,0 +1,2 @@
+import type { TProperties, TTemplateLiteral } from '../../type/index.mjs';
+export declare function FromTemplateLiteral(context: TProperties, type: TTemplateLiteral, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_tuple.d.mts

@@ -0,0 +1,2 @@
+import type { TProperties, TTuple } from '../../type/index.mjs';
+export declare function FromTuple(context: TProperties, schema: TTuple, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_type.d.mts

@@ -0,0 +1,2 @@
+import * as T from '../../type/index.mjs';
+export declare function FromType(context: T.TProperties, type: T.TSchema, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_union.d.mts

@@ -0,0 +1,2 @@
+import { type TProperties, type TUnion } from '../../type/index.mjs';
+export declare function FromUnion(context: TProperties, type: TUnion, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/from_unknown.d.mts

@@ -0,0 +1,2 @@
+import type { TProperties, TSchema } from '../../type/index.mjs';
+export declare function FromUnknown(context: TProperties, type: TSchema, value: unknown): unknown;

package/assets/types/typebox/build/value/repair/index.d.mts

@@ -0,0 +1 @@
+export * from './repair.mjs';

package/assets/types/typebox/build/value/repair/repair.d.mts

@@ -0,0 +1,17 @@
+import type { TProperties, TSchema, Static } from '../../type/index.mjs';
+/**
+ * Repairs a value to match the provided type. This function is intended for data migration
+ * scenarios where existing values need to be migrating to an updated type. This function will
+ * repair partially mismatched values by populating missing sub-properties and elements with
+ * default structures derived from the type. If the value already conforms to the type, no
+ * action is performed.
+ */
+export declare function Repair<const Type extends TSchema>(type: Type, value: unknown): Static<Type>;
+/**
+ * Repairs a value to match the provided type. This function is intended for data migration
+ * scenarios where existing values need to be migrating to an updated type. This function will
+ * repair partially mismatched values by populating missing sub-properties and elements with
+ * default structures derived from the type. If the value already conforms to the type, no
+ * action is performed.
+ */
+export declare function Repair<Context extends TProperties, const Type extends TSchema>(context: Context, type: Type, value: unknown): Static<Type, Context>;

package/assets/types/typebox/build/value/shared/index.d.mts

@@ -0,0 +1,3 @@
+export * from './optional_undefined.mjs';
+export * from './union_priority_sort.mjs';
+export * from './union_score_select.mjs';

package/assets/types/typebox/build/value/shared/optional_undefined.d.mts

@@ -0,0 +1,2 @@
+import { type TSchema } from '../../type/index.mjs';
+export declare function IsOptionalUndefined(property: TSchema, key: PropertyKey, value: Record<PropertyKey, unknown>): boolean;

package/assets/types/typebox/build/value/shared/union_priority_sort.d.mts

@@ -0,0 +1,7 @@
+import { type TSchema } from '../../type/index.mjs';
+/**
+ * (Type-Preprocessor) Recursively reorders Union variants from narrowest to broadest, ensuring
+ * more specific types (e.g. Literal) are evaluated before broader types (e.g. String). Used
+ * prior to Clean, Decode, and Encode operations.
+ */
+export declare function UnionPrioritySort(type: TSchema): TSchema;

package/assets/types/typebox/build/value/shared/union_score_select.d.mts

@@ -0,0 +1,3 @@
+import { type TProperties, type TSchema, type TUnion } from '../../type/index.mjs';
+/** Scores Union variants and returns the best match for the given value */
+export declare function UnionScoreSelect(context: TProperties, type: TUnion, value: unknown): TSchema;

package/assets/types/typebox/build/value/value.d.mts

@@ -0,0 +1,15 @@
+export { Assert } from './assert/index.mjs';
+export { Check } from './check/index.mjs';
+export { Clean } from './clean/index.mjs';
+export { Clone } from './clone/index.mjs';
+export { Decode, Encode, HasCodec } from './codec/index.mjs';
+export { Convert } from './convert/index.mjs';
+export { Create } from './create/index.mjs';
+export { Default } from './default/index.mjs';
+export { Equal } from './equal/index.mjs';
+export { Errors } from './errors/index.mjs';
+export { Hash } from './hash/index.mjs';
+export { Parse } from './parse/index.mjs';
+export { Diff, Patch } from './delta/index.mjs';
+export { Pointer } from './pointer/index.mjs';
+export { Repair } from './repair/index.mjs';

package/assets/types/typebox/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "typebox",
+  "description": "Json Schema Type Builder with Static Type Resolution for TypeScript",
+  "version": "1.3.7",
+  "keywords": [
+    "typescript",
+    "jsonschema"
+  ],
+  "license": "MIT",
+  "author": "sinclairzx81",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sinclairzx81/typebox"
+  },
+  "type": "module",
+  "types": "./build/index.d.mts",
+  "module": "./build/index.mjs",
+  "exports": {
+    "./schema": {
+      "import": "./build/schema/index.mjs",
+      "default": "./build/schema/index.mjs"
+    },
+    "./system": {
+      "import": "./build/system/index.mjs",
+      "default": "./build/system/index.mjs"
+    },
+    "./compile": {
+      "import": "./build/compile/index.mjs",
+      "default": "./build/compile/index.mjs"
+    },
+    "./value": {
+      "import": "./build/value/index.mjs",
+      "default": "./build/value/index.mjs"
+    },
+    "./type": {
+      "import": "./build/type/index.mjs",
+      "default": "./build/type/index.mjs"
+    },
+    "./error": {
+      "import": "./build/error/index.mjs",
+      "default": "./build/error/index.mjs"
+    },
+    "./format": {
+      "import": "./build/format/index.mjs",
+      "default": "./build/format/index.mjs"
+    },
+    "./guard": {
+      "import": "./build/guard/index.mjs",
+      "default": "./build/guard/index.mjs"
+    },
+    ".": {
+      "import": "./build/index.mjs",
+      "default": "./build/index.mjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "schema": [
+        "./build/schema/index.d.mts"
+      ],
+      "system": [
+        "./build/system/index.d.mts"
+      ],
+      "compile": [
+        "./build/compile/index.d.mts"
+      ],
+      "value": [
+        "./build/value/index.d.mts"
+      ],
+      "type": [
+        "./build/type/index.d.mts"
+      ],
+      "error": [
+        "./build/error/index.d.mts"
+      ],
+      "format": [
+        "./build/format/index.d.mts"
+      ],
+      "guard": [
+        "./build/guard/index.d.mts"
+      ],
+      ".": [
+        "./build/index.d.mts"
+      ]
+    }
+  }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@yaag/cli",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "assets",
+    "!src/**/*.test.ts",
+    "!src/fixtures"
+  ],
+  "type": "module",
+  "bin": {
+    "yaag": "./src/cli.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "bun test src scripts",
+    "test:e2e": "bun test e2e"
+  },
+  "dependencies": {
+    "@earendil-works/pi-tui": "^0.84.0",
+    "@yaag/runtime": "0.0.0",
+    "@yaag/tui": "0.0.0",
+    "typebox": "1.3.7"
+  }
+}

package/src/alt-screen.ts

@@ -0,0 +1,46 @@
+/**
+ * The production edge of the interactive Run view: the real terminal, and the
+ * one predicate that decides whether to open it.
+ *
+ * Construction only; the app's behavior lives in `tree-app.ts`.
+ */
+import { ProcessTerminal, type TUI, TuiAltScreen } from "@earendil-works/pi-tui";
+
+/** One stream, as the predicate reads it. */
+export interface StreamTty {
+  readonly isTTY?: boolean | undefined;
+}
+
+/** The three streams the interactive view needs, plus the `--quiet` flag. */
+export interface InteractiveOptions {
+  readonly stdin: StreamTty;
+  readonly stdout: StreamTty;
+  readonly stderr: StreamTty;
+  readonly quiet: boolean;
+}
+
+/**
+ * Reports whether `yaag run` may open the alt-screen tree.
+ *
+ * All three streams must be a TTY: `ProcessTerminal` draws its frames on
+ * stdout, so a piped stdout would corrupt the pipeable Run result
+ * (architecture §9). Any other case keeps the plain sanitized lines.
+ */
+export function interactiveAvailable(options: InteractiveOptions): boolean {
+  return (
+    !options.quiet &&
+    options.stdin.isTTY === true &&
+    options.stdout.isTTY === true &&
+    options.stderr.isTTY === true
+  );
+}
+
+/**
+ * Builds the alt-screen TUI over the real process streams.
+ *
+ * Mouse capture stays off: the tree binds no mouse gesture, and capture would
+ * take terminal text selection away from the reader.
+ */
+export function createAltScreen(): TUI {
+  return new TuiAltScreen(new ProcessTerminal(), false, undefined, { mouse: false });
+}

package/src/argv.ts

@@ -0,0 +1,147 @@
+/**
+ * Hand-rolled parsing for the small `run`, `describe`, and `setup-workspace` CLI surface (ADR-0010).
+ * A dependency would cost more than the parser it replaces.
+ */
+import { resolve } from "node:path";
+
+export const USAGE = `usage:
+  yaag run <program.ts> [--quiet] [--args <json>] [--record <file>] [--replay <file>] [--resume <file>] [--events-fd <n>]
+  yaag describe <program.ts>
+  yaag setup-workspace [dir]
+
+Warning: describe imports the module and executes its top level. Keep program module top level side-effect free.`;
+
+export type ParsedArgv =
+  | {
+      readonly ok: true;
+      readonly command: "run";
+      readonly file: string;
+      /** Opaque: parsed JSON, never validated here (ADR-0010). */
+      readonly args: unknown;
+      readonly quiet: boolean;
+      readonly eventsFd?: number;
+      readonly record?: string;
+      readonly replay?: string;
+      readonly resume?: string;
+    }
+  | { readonly ok: true; readonly command: "describe"; readonly file: string }
+  | { readonly ok: true; readonly command: "setup-workspace"; readonly dir: string }
+  | { readonly ok: false; readonly error: string };
+
+/** Parses CLI arguments. Every failure is a bad invocation (exit code 2). */
+export function parseArgv(argv: readonly string[]): ParsedArgv {
+  switch (argv[0]) {
+    case "run":
+      return parseRun(argv.slice(1));
+    case "describe":
+      return parseDescribe(argv.slice(1));
+    case "setup-workspace":
+      return parseSetupWorkspace(argv.slice(1));
+    default:
+      return failure(USAGE);
+  }
+}
+
+function parseRun(tokens: readonly string[]): ParsedArgv {
+  let file: string | undefined;
+  let args: unknown = {};
+  let eventsFd: number | undefined;
+  let record: string | undefined;
+  let replay: string | undefined;
+  let resume: string | undefined;
+  let quiet = false;
+
+  for (let index = 0; index < tokens.length; index += 1) {
+    const token = tokens[index] ?? "";
+    if (token === "--quiet") {
+      quiet = true;
+    } else if (
+      token === "--args" ||
+      token === "--events-fd" ||
+      token === "--record" ||
+      token === "--replay" ||
+      token === "--resume"
+    ) {
+      const value = tokens[index + 1];
+      if (value === undefined) return failure(`${token} needs a value\n${USAGE}`);
+      index += 1;
+      if (token === "--args") {
+        const parsed = parseJson(value);
+        if (!parsed.ok) return parsed;
+        args = parsed.value;
+      } else if (token === "--events-fd") {
+        const parsed = parseDescriptor(value);
+        if (!parsed.ok) return parsed;
+        eventsFd = parsed.value;
+      } else if (token === "--record") {
+        record = value;
+      } else if (token === "--replay") {
+        replay = value;
+      } else {
+        resume = value;
+      }
+    } else if (token.startsWith("-")) {
+      return failure(`unknown option ${token}\n${USAGE}`);
+    } else if (file !== undefined) {
+      return failure(`unexpected operand ${token}\n${USAGE}`);
+    } else {
+      file = token;
+    }
+  }
+
+  if (file === undefined) return failure(USAGE);
+  if (record !== undefined && replay !== undefined) {
+    return failure(`--record and --replay cannot be used together\n${USAGE}`);
+  }
+  if (resume !== undefined && replay !== undefined) {
+    return failure(`--resume and --replay cannot be used together\n${USAGE}`);
+  }
+  if (resume !== undefined && record !== undefined && resolve(resume) === resolve(record)) {
+    return failure(`--resume and --record must use different paths\n${USAGE}`);
+  }
+  return {
+    ok: true,
+    command: "run",
+    file,
+    args,
+    quiet,
+    ...(eventsFd === undefined ? {} : { eventsFd }),
+    ...(record === undefined ? {} : { record }),
+    ...(replay === undefined ? {} : { replay }),
+    ...(resume === undefined ? {} : { resume }),
+  };
+}
+
+function parseDescribe(tokens: readonly string[]): ParsedArgv {
+  if (tokens.length !== 1 || tokens[0]?.startsWith("-")) return failure(USAGE);
+  return { ok: true, command: "describe", file: tokens[0] };
+}
+
+function parseSetupWorkspace(tokens: readonly string[]): ParsedArgv {
+  if (tokens.length === 0) return { ok: true, command: "setup-workspace", dir: process.cwd() };
+  if (tokens.length !== 1 || tokens[0]?.startsWith("-")) return failure(USAGE);
+  return { ok: true, command: "setup-workspace", dir: tokens[0] };
+}
+
+type ParsedValue<T> =
+  | { readonly ok: true; readonly value: T }
+  | { readonly ok: false; readonly error: string };
+
+function parseJson(value: string): ParsedValue<unknown> {
+  try {
+    return { ok: true, value: JSON.parse(value) };
+  } catch (error) {
+    return failure(`--args is not valid JSON: ${String(error)}`);
+  }
+}
+
+function parseDescriptor(value: string): ParsedValue<number> {
+  const fd = Number(value);
+  return Number.isInteger(fd) && fd >= 0
+    ? { ok: true, value: fd }
+    : failure(`--events-fd must be a descriptor number\n${USAGE}`);
+}
+
+function failure(error: string): { readonly ok: false; readonly error: string } {
+  return { ok: false, error };
+}

package/src/cli-tree-host.ts

@@ -0,0 +1,81 @@
+/**
+ * The read-only half of `RunTreeViewHost` for the standalone CLI (spec §4).
+ *
+ * The Host Session gets the same shape from `packages/extension`; here the pi
+ * services are replaced by pi-tui primitives, so `apps/yaag` needs no pi. The
+ * caller adds `stop`, `detach`, and `done`: nothing in this module can prompt
+ * an Agent (ADR — a Peek observes, it never sends).
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import type { Terminal } from "@earendil-works/pi-tui";
+import type { AgentInfo } from "@yaag/runtime";
+import { cliKeybindings, type RunTreeViewHost, type TreeState } from "@yaag/tui";
+
+/** The terminal services one open CLI view holds. */
+export interface CliTreeHostOptions {
+  readonly terminal: Pick<Terminal, "write" | "rows">;
+  /** The Run's projection; the host only reads it. */
+  readonly state: TreeState;
+  /** Shows a transient message; `tree-app.ts` routes it to the TUI. */
+  notify(message: string, level: "info" | "warning" | "error"): void;
+  requestRender(): void;
+  /** Where `openEditor` puts the body; defaults to the system temp directory. */
+  readonly scratchDir?: string;
+}
+
+/** The read-only capabilities the CLI Run view has. */
+export type ReadOnlyCliHost = Omit<RunTreeViewHost, "stop" | "detach" | "done">;
+
+/** Builds the CLI's read-only host; it never writes to an Agent or to the Run. */
+export function createCliTreeHost(options: CliTreeHostOptions): ReadOnlyCliHost {
+  const { state, terminal } = options;
+  return {
+    keybindings: cliKeybindings(),
+    agentInfo: (agent) => state.summary.agents[agent],
+    readSession: (agent) => readSession(state.summary.agents[agent]),
+    sessionPath: (agent) => state.summary.agents[agent]?.sessionFile ?? null,
+    // OSC 52 is the only copy path that works over SSH without a child
+    // process, and it is what pi-tui itself uses for its own copy gesture.
+    copyPath: async (text) => {
+      terminal.write(`\u001b]52;c;${Buffer.from(text, "utf8").toString("base64")}\u0007`);
+    },
+    // Spawning $EDITOR inside a live alt-screen would fight the TUI for the
+    // terminal, so the body lands in a file and the path is reported instead.
+    openEditor: async (title, body) => {
+      const path = join(options.scratchDir ?? tmpdir(), scratchName(title));
+      try {
+        await writeFile(path, body, "utf8");
+        options.notify(`Wrote ${title} to ${path}`, "info");
+      } catch (error) {
+        options.notify(`Could not write ${title}: ${message(error)}`, "error");
+      }
+    },
+    notify: (text, level) => options.notify(text, level),
+    requestRender: () => options.requestRender(),
+    rows: () => Math.max(1, terminal.rows - 1),
+  };
+}
+
+/** Reads an Agent's session file, or null when it is missing or unreadable. */
+async function readSession(info: AgentInfo | undefined): Promise<string | null> {
+  const path = info?.sessionFile;
+  if (path === undefined || path === null) return null;
+  try {
+    return await readFile(path, "utf8");
+  } catch {
+    // The file does not exist until the first Ask completes (ADR-0012), and a
+    // Cassette-playback Agent never had one; both degrade to the labelled stub.
+    return null;
+  }
+}
+
+function scratchName(title: string): string {
+  const slug = title.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "");
+  return `yaag-${slug === "" ? "note" : slug}.txt`;
+}
+
+function message(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}