lalph 0.3.31 → 0.3.32

package/dist/cli.mjs

@@ -5241,6 +5241,37 @@ const getFailure$1 = getFailure$2;
 */
 const getOrElse$1 = /* @__PURE__ */ dual(2, (self, onNone) => isNone(self) ? onNone() : self.value);
 /**
+* Returns `Some` of the fallback value if `self` is `None`; otherwise returns
+* `self`.
+*
+* **When to use**
+*
+* - Providing a default plain value (not an `Option`) as fallback
+*
+* **Behavior**
+*
+* - `Some` → returns `self` unchanged
+* - `None` → calls `onNone()`, wraps result in `Some`, and returns it
+*
+* **Example** (Providing a fallback value)
+*
+* ```ts
+* import { Option } from "effect"
+*
+* console.log(Option.none().pipe(Option.orElseSome(() => "b")))
+* // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
+*
+* console.log(Option.some("a").pipe(Option.orElseSome(() => "b")))
+* // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+* ```
+*
+* @see {@link orElse} when the fallback is itself an `Option`
+*
+* @category Error handling
+* @since 2.0.0
+*/
+const orElseSome = /* @__PURE__ */ dual(2, (self, onNone) => isNone(self) ? some$2(onNone()) : self);
+/**
 * Converts a nullable value (`null` or `undefined`) into an `Option`.
 *
 * **When to use**
@@ -25876,6 +25907,69 @@ function passthrough$1() {
 	return passthrough_$1;
 }
 /**
+* Creates a getter that handles the case when the input is absent (`Option.None`).
+*
+* Use this when:
+* - You need to provide a fallback or computed value for missing struct keys.
+* - Building custom "default value" logic more complex than {@link withDefault}.
+*
+* Behavior:
+* - When input is `None`, calls `f` to produce the result.
+* - When input is `Some`, passes it through unchanged.
+* - `f` receives the parse options and may return `None` to keep the value absent.
+*
+* **Example** (Default timestamp for missing field)
+*
+* ```ts
+* import { SchemaGetter, Effect, Option } from "effect"
+*
+* const withTimestamp = SchemaGetter.onNone<number>(() =>
+*   Effect.succeed(Option.some(Date.now()))
+* )
+* ```
+*
+* See also:
+* - {@link required} — fails if input is absent
+* - {@link withDefault} — simpler default value for undefined inputs
+* - {@link onSome} — handle only present values
+*
+* @category Constructors
+* @since 4.0.0
+*/
+function onNone(f) {
+	return new Getter((ot, options) => isNone(ot) ? f(options) : succeed$1(ot));
+}
+/**
+* Creates a getter that fails with `MissingKey` if the input is absent (`Option.None`).
+*
+* Use this when:
+* - A struct field must be present in the encoded input.
+* - You want schema validation to report a missing key error.
+*
+* Behavior:
+* - When input is `None`, fails with `Issue.MissingKey`.
+* - When input is `Some`, passes it through unchanged.
+* - Optional `annotations` customize the error message for the missing key.
+*
+* **Example** (Required struct field)
+*
+* ```ts
+* import { SchemaGetter } from "effect"
+*
+* const mustExist = SchemaGetter.required<string>()
+* ```
+*
+* See also:
+* - {@link onNone} — provide a fallback instead of failing
+* - {@link withDefault} — substitute a default for undefined values
+*
+* @category Constructors
+* @since 4.0.0
+*/
+function required(annotations) {
+	return onNone(() => fail$4(new MissingKey(annotations)));
+}
+/**
 * Creates a getter that handles present values (`Option.Some`), passing `None` through.
 *
 * Use this when:
@@ -26016,6 +26110,36 @@ function transformOptional(f) {
 	return new Getter((oe) => succeed$1(f(oe)));
 }
 /**
+* Creates a getter that replaces `undefined` values with a default.
+*
+* Use this when:
+* - A field may be `undefined` in the encoded input and should have a fallback.
+*
+* Behavior:
+* - If the input is `Some(undefined)` or `None`, produces `Some(defaultValue())`.
+* - If the input is `Some(value)` where value is not `undefined`, passes it through.
+* - `defaultValue` is called lazily each time a default is needed.
+*
+* **Example** (Default value for optional field)
+*
+* ```ts
+* import { SchemaGetter } from "effect"
+*
+* const withZero = SchemaGetter.withDefault(() => 0)
+* // Getter<number, number | undefined>
+* ```
+*
+* See also:
+* - {@link onNone} — handle only absent keys (not `undefined` values)
+* - {@link required} — fail instead of providing a default
+*
+* @category Constructors
+* @since 4.0.0
+*/
+function withDefault$4(defaultValue) {
+	return transformOptional((o) => o.pipe(filter$9(isNotUndefined), orElseSome(defaultValue)));
+}
+/**
 * Coerces any value to a `string` using the global `String()` constructor.
 *
 * Use this when:
@@ -28103,7 +28227,7 @@ const isNumberStringRegExp = /* @__PURE__ */ new globalThis.RegExp(`(?:${FINITE_
 * @internal
 */
 function getIndexSignatureKeys(input, parameter) {
-	const encoded = toEncoded(parameter);
+	const encoded = toEncoded$1(parameter);
 	switch (encoded._tag) {
 		case "String": return Object.keys(input);
 		case "TemplateLiteral": {
@@ -28464,7 +28588,7 @@ function getIndex(types) {
 	if (idx) return idx;
 	idx = {};
 	for (const a of types) {
-		const encoded = toEncoded(a);
+		const encoded = toEncoded$1(a);
 		if (isNever(encoded)) continue;
 		const types = getCandidateTypes(encoded);
 		const sentinels = collectSentinels(encoded);
@@ -28489,7 +28613,7 @@ function getIndex(types) {
 }
 function filterLiterals(input) {
 	return (ast) => {
-		const encoded = toEncoded(ast);
+		const encoded = toEncoded$1(ast);
 		return encoded._tag === "Literal" ? encoded.literal === input : encoded._tag === "UniqueSymbol" ? encoded.symbol === input : true;
 	};
 }
@@ -28601,7 +28725,7 @@ var Union$1 = class Union$1 extends Base {
 		if (typeof expected === "string") return expected;
 		if (this.types.length === 0) return "never";
 		const types = this.types.map((type) => {
-			const encoded = toEncoded(type);
+			const encoded = toEncoded$1(type);
 			switch (encoded._tag) {
 				case "Arrays": {
 					const literals = encoded.elements.filter(isLiteral);
@@ -29017,10 +29141,10 @@ function isMutable(ast) {
 *
 * @since 4.0.0
 */
-const toType = /* @__PURE__ */ memoize((ast) => {
-	if (ast.encoding) return toType(replaceEncoding(ast, void 0));
+const toType$1 = /* @__PURE__ */ memoize((ast) => {
+	if (ast.encoding) return toType$1(replaceEncoding(ast, void 0));
 	const out = ast;
-	return out.recur?.(toType) ?? out;
+	return out.recur?.(toType$1) ?? out;
 });
 /**
 * Returns the encoded (wire-format) AST by flipping and then stripping
@@ -29047,8 +29171,8 @@ const toType = /* @__PURE__ */ memoize((ast) => {
 *
 * @since 4.0.0
 */
-const toEncoded = /* @__PURE__ */ memoize((ast) => {
-	return toType(flip(ast));
+const toEncoded$1 = /* @__PURE__ */ memoize((ast) => {
+	return toType$1(flip(ast));
 });
 function flipEncoding(ast, encoding) {
 	const links = encoding;
@@ -38014,7 +38138,7 @@ const recurDefaults = /* @__PURE__ */ memoize((ast) => {
 * @since 4.0.0
 */
 function makeEffect$1(schema) {
-	const parser = run$6(recurDefaults(toType(schema.ast)));
+	const parser = run$6(recurDefaults(toType$1(schema.ast)));
 	return (input, options) => {
 		return parser(input, options?.parseOptions);
 	};
@@ -38038,7 +38162,7 @@ function is$1(schema) {
 }
 /** @internal */
 function _is(ast) {
-	const parser = asExit(run$6(toType(ast)));
+	const parser = asExit(run$6(toType$1(ast)));
 	return (input) => {
 		return isSuccess$3(parser(input, defaultParseOptions));
 	};
@@ -38048,7 +38172,7 @@ function _is(ast) {
 * @since 4.0.0
 */
 function asserts$1(schema) {
-	const parser = asExit(run$6(toType(schema.ast)));
+	const parser = asExit(run$6(toType$1(schema.ast)));
 	return (input) => {
 		const exit = parser(input, defaultParseOptions);
 		if (isFailure$2(exit)) {
@@ -38359,7 +38483,7 @@ function toCodecJsonBase(ast) {
 		case "Declaration": {
 			const getLink = ast.annotations?.toCodecJson ?? ast.annotations?.toCodec;
 			if (isFunction(getLink)) {
-				const link = getLink(isDeclaration(ast) ? ast.typeParameters.map((tp) => make$38(toEncoded(tp))) : []);
+				const link = getLink(isDeclaration(ast) ? ast.typeParameters.map((tp) => make$38(toEncoded$1(tp))) : []);
 				const to = toCodecJson$1(link.to);
 				return replaceEncoding(ast, to === link.to ? [link] : [new Link(to, link.transformation)]);
 			}
@@ -38399,10 +38523,10 @@ function getJsonPriority(ast) {
 function makeReorder(getPriority) {
 	return (types) => {
 		const indexMap = /* @__PURE__ */ new Map();
-		for (let i = 0; i < types.length; i++) indexMap.set(toEncoded(types[i]), i);
+		for (let i = 0; i < types.length; i++) indexMap.set(toEncoded$1(types[i]), i);
 		const sortedTypes = [...types].sort((a, b) => {
-			a = toEncoded(a);
-			b = toEncoded(b);
+			a = toEncoded$1(a);
+			b = toEncoded$1(b);
 			const pa = getPriority(a);
 			const pb = getPriority(b);
 			if (pa !== pb) return pa - pb;
@@ -38537,7 +38661,7 @@ function fromASTs(asts) {
 	function getEncodedSchema(last) {
 		const getLink = last.annotations?.toCodecJson ?? last.annotations?.toCodec;
 		if (isFunction(getLink)) {
-			const link = getLink(last.typeParameters.map((tp) => make$38(toEncoded(tp))));
+			const link = getLink(last.typeParameters.map((tp) => make$38(toEncoded$1(tp))));
 			return replaceEncoding(last, [link]);
 		}
 		return null_;
@@ -39329,6 +39453,14 @@ const optionalKey = /* @__PURE__ */ lambda((schema) => make$37(optionalKey$1(sch
 */
 const optional$2 = /* @__PURE__ */ lambda((self) => optionalKey(UndefinedOr(self)));
 /**
+* @since 4.0.0
+*/
+const toType = /* @__PURE__ */ lambda((schema) => make$37(toType$1(schema.ast), { schema }));
+/**
+* @since 4.0.0
+*/
+const toEncoded = /* @__PURE__ */ lambda((schema) => make$37(toEncoded$1(schema.ast), { schema }));
+/**
 * @see {@link Literals} for a schema that represents a union of literals.
 * @see {@link tag} for a schema that represents a literal value that can be
 * used as a discriminator field in tagged unions and has a constructor default.
@@ -40946,7 +41078,7 @@ function fromJsonString(schema) {
 	return String$1.annotate({
 		expected: "a string that will be decoded as JSON",
 		contentMediaType: "application/json",
-		contentSchema: toEncoded(schema.ast)
+		contentSchema: toEncoded$1(schema.ast)
 	}).pipe(decodeTo(schema, fromJsonString$1));
 }
 /**
@@ -41440,7 +41572,7 @@ function serializerTree(ast, recur, onMissingAnnotation) {
 		case "Declaration": {
 			const getLink = ast.annotations?.toCodecJson ?? ast.annotations?.toCodec;
 			if (isFunction(getLink)) {
-				const link = getLink(isDeclaration(ast) ? ast.typeParameters.map((tp) => make$37(recur(toEncoded(tp)))) : []);
+				const link = getLink(isDeclaration(ast) ? ast.typeParameters.map((tp) => make$37(recur(toEncoded$1(tp)))) : []);
 				const to = recur(link.to);
 				return replaceEncoding(ast, to === link.to ? [link] : [new Link(to, link.transformation)]);
 			}
@@ -41833,7 +41965,7 @@ const recur = /* @__PURE__ */ fnUntraced(function* (ast, provider, path) {
 function schema(codec, path) {
 	const toCodecStringTree$2 = toCodecStringTree(codec);
 	const decodeUnknownEffect = decodeUnknownEffect$1(toCodecStringTree$2);
-	const toCodecStringTreeEncoded = toEncoded(toCodecStringTree$2.ast);
+	const toCodecStringTreeEncoded = toEncoded$1(toCodecStringTree$2.ast);
 	const defaultPath = typeof path === "string" ? [path] : path ?? [];
 	return make$36((provider) => {
 		const path = provider.prefix ? [...provider.prefix, ...defaultPath] : defaultPath;
@@ -73807,33 +73939,46 @@ var ProjectSetting = class {
 };
 const selectedCliAgentId = new Setting("selectedCliAgentId", Literals(allCliAgents.map((a) => a.id)));
 
+//#endregion
+//#region src/shared/schema.ts
+const withEncodeDefault = (defaultValue) => (schema) => optionalKey(schema).pipe(decodeTo(toType(schema), {
+	decode: withDefault$4(defaultValue),
+	encode: required()
+}));
+
 //#endregion
 //#region src/domain/PrdIssue.ts
 var PrdIssue = class PrdIssue extends Class$1("PrdIssue")({
-	id: NullOr(String$1).annotate({ description: "The unique identifier of the issue. If null, it is considered a new issue." }),
+	id: NullOr(String$1).annotate({ description: "The unique identifier of the issue. If null, it is considered a new issue." }).pipe(withEncodeDefault(() => null)),
 	title: String$1.annotate({ description: "The title of the issue" }),
-	description: String$1.annotate({ description: "The description of the issue in markdown format." }),
-	priority: Finite.annotate({ description: "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low." }),
-	estimate: NullOr(Finite).annotate({ description: "The estimate of the issue in points. Null if no estimate is set. Roughly 1 point = 1 hour of work." }),
+	description: String$1.annotate({ description: "The description of the issue in markdown format." }).pipe(withEncodeDefault(() => "")),
+	priority: Finite.annotate({ description: "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low." }).pipe(withEncodeDefault(() => 3)),
+	estimate: NullOr(Finite).annotate({ description: "The estimate of the issue in points. Null if no estimate is set. Roughly 1 point = 1 hour of work." }).pipe(withEncodeDefault(() => null)),
 	state: Literals([
 		"backlog",
 		"todo",
 		"in-progress",
 		"in-review",
 		"done"
-	]).annotate({ description: "The state of the issue." }),
-	blockedBy: Array$1(String$1).annotate({ description: "An array of issue IDs that block this issue. These issues must be completed before this issue can be worked on." }),
-	autoMerge: Boolean$2.annotate({ description: "Whether the issue should be auto-merged when complete. Read-only field" })
+	]).annotate({ description: "The state of the issue." }).pipe(withEncodeDefault(() => "todo")),
+	blockedBy: Array$1(String$1).annotate({ description: "An array of issue IDs that block this issue. These issues must be completed before this issue can be worked on." }).pipe(withEncodeDefault(() => [])),
+	autoMerge: Boolean$2.annotate({ description: "Whether the issue should be auto-merged when complete. Read-only field" }).pipe(withEncodeDefault(() => false))
 }) {
+	static FromInput = Union([String$1, toEncoded(PrdIssue)]).pipe(decodeTo(PrdIssue, {
+		decode: transform$3((s) => typeof s === "string" ? { title: s } : s),
+		encode: passthrough$1()
+	}));
 	static Array = Array$1(this);
+	static ArrayFromInput = Array$1(this.FromInput);
 	static ArrayFromJson = toCodecJson(this.Array);
+	static ArrayFromJsonInput = toCodecJson(this.ArrayFromInput);
 	static arrayToYaml(issues) {
 		const json = encodeSync(this.ArrayFromJson)(issues);
 		return import_dist.stringify(json, { blockQuote: "literal" });
 	}
 	static arrayFromYaml(yaml) {
 		const json = import_dist.parse(yaml);
-		return decodeSync(PrdIssue.ArrayFromJson)(json);
+		return decodeSync(PrdIssue.ArrayFromJsonInput)(json);
 	}
 	static jsonSchemaDoc = toJsonSchemaDocument(this);
 	static jsonSchema = {
@@ -159542,7 +159687,7 @@ const commandSource = make$34("source").pipe(withDescription("Select the issue s
 
 //#endregion
 //#region package.json
-var version = "0.3.31";
+var version = "0.3.32";
 
 //#endregion
 //#region src/commands/projects/ls.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lalph",
   "type": "module",
-  "version": "0.3.31",
+  "version": "0.3.32",
   "publishConfig": {
     "access": "public"
   },

package/src/domain/PrdIssue.ts

@@ -1,52 +1,75 @@
-import { Schema, Array, Equal } from "effect"
+import { Schema, Array, Equal, SchemaGetter } from "effect"
 import * as Yaml from "yaml"
+import { withEncodeDefault } from "../shared/schema.ts"
 
 export class PrdIssue extends Schema.Class<PrdIssue>("PrdIssue")({
-  id: Schema.NullOr(Schema.String).annotate({
-    description:
-      "The unique identifier of the issue. If null, it is considered a new issue.",
-  }),
+  id: Schema.NullOr(Schema.String)
+    .annotate({
+      description:
+        "The unique identifier of the issue. If null, it is considered a new issue.",
+    })
+    .pipe(withEncodeDefault(() => null)),
   title: Schema.String.annotate({
     description: "The title of the issue",
   }),
   description: Schema.String.annotate({
     description: "The description of the issue in markdown format.",
-  }),
+  }).pipe(withEncodeDefault(() => "")),
   priority: Schema.Finite.annotate({
     description:
       "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.",
-  }),
-  estimate: Schema.NullOr(Schema.Finite).annotate({
-    description:
-      "The estimate of the issue in points. Null if no estimate is set. Roughly 1 point = 1 hour of work.",
-  }),
+  }).pipe(withEncodeDefault(() => 3)),
+  estimate: Schema.NullOr(Schema.Finite)
+    .annotate({
+      description:
+        "The estimate of the issue in points. Null if no estimate is set. Roughly 1 point = 1 hour of work.",
+    })
+    .pipe(withEncodeDefault(() => null)),
   state: Schema.Literals([
     "backlog",
     "todo",
     "in-progress",
     "in-review",
     "done",
-  ]).annotate({
-    description: "The state of the issue.",
-  }),
-  blockedBy: Schema.Array(Schema.String).annotate({
-    description:
-      "An array of issue IDs that block this issue. These issues must be completed before this issue can be worked on.",
-  }),
+  ])
+    .annotate({
+      description: "The state of the issue.",
+    })
+    .pipe(withEncodeDefault(() => "todo")),
+  blockedBy: Schema.Array(Schema.String)
+    .annotate({
+      description:
+        "An array of issue IDs that block this issue. These issues must be completed before this issue can be worked on.",
+    })
+    .pipe(withEncodeDefault(() => [])),
   autoMerge: Schema.Boolean.annotate({
     description:
       "Whether the issue should be auto-merged when complete. Read-only field",
-  }),
+  }).pipe(withEncodeDefault(() => false)),
 }) {
+  static FromInput = Schema.Union([
+    Schema.String,
+    Schema.toEncoded(PrdIssue),
+  ]).pipe(
+    Schema.decodeTo(PrdIssue, {
+      decode: SchemaGetter.transform((s) =>
+        typeof s === "string" ? { title: s } : s,
+      ),
+      encode: SchemaGetter.passthrough(),
+    }),
+  )
+
   static Array = Schema.Array(this)
+  static ArrayFromInput = Schema.Array(this.FromInput)
   static ArrayFromJson = Schema.toCodecJson(this.Array)
+  static ArrayFromJsonInput = Schema.toCodecJson(this.ArrayFromInput)
   static arrayToYaml(issues: ReadonlyArray<PrdIssue>): string {
     const json = Schema.encodeSync(this.ArrayFromJson)(issues)
     return Yaml.stringify(json, { blockQuote: "literal" })
   }
   static arrayFromYaml(yaml: string): ReadonlyArray<PrdIssue> {
     const json = Yaml.parse(yaml)
-    const issues = Schema.decodeSync(PrdIssue.ArrayFromJson)(json)
+    const issues = Schema.decodeSync(PrdIssue.ArrayFromJsonInput)(json)
     return issues
   }
 

package/src/shared/schema.ts

@@ -0,0 +1,11 @@
+import { Schema, SchemaGetter } from "effect"
+
+export const withEncodeDefault =
+  <S extends Schema.Top>(defaultValue: () => S["Type"]) =>
+  (schema: S) =>
+    Schema.optionalKey(schema).pipe(
+      Schema.decodeTo(Schema.toType(schema), {
+        decode: SchemaGetter.withDefault(defaultValue),
+        encode: SchemaGetter.required(),
+      }),
+    )