lalph 0.3.24 → 0.3.25

package/README.md

@@ -70,14 +70,17 @@ lalph projects toggle
 
 ## Plan mode
 
-Plan mode opens an editor so you can write a high-level plan. On save, lalph
-generates a specification under `--specs` and then creates PRD tasks from it.
+Plan mode opens an editor so you can write a high-level plan. You can also pass
+`--file` / `-f` with a markdown file path to skip the editor. On save (or file
+read), lalph generates a specification under `--specs` and then creates PRD
+tasks from it.
 
 Use `--dangerous` to skip permission prompts during spec generation, and `--new`
 to create a project before starting plan mode.
 
 ```bash
 lalph plan
+lalph plan --file ./my-plan.md
 lalph plan tasks .specs/my-spec.md
 ```
 

package/dist/cli.mjs

@@ -49627,6 +49627,35 @@ const directory$1 = (kind, name, options) => path$1(kind, name, {
 	mustExist: options?.mustExist
 });
 /**
+* Creates a file path parameter.
+*
+* This is a convenience function that creates a path parameter with a
+* `pathType` set to `"file"` and a default type name of `"file"`.
+*
+* @example
+* ```ts
+* import * as Param from "effect/unstable/cli/Param"
+*
+* // @internal - this module is not exported publicly
+*
+* // Basic file parameter
+* const outputFile = Param.file(Param.flagKind, "output")
+*
+* // File that must exist
+* const inputFile = Param.file(Param.flagKind, "input", { mustExist: true })
+*
+* // Usage: --output result.txt --input existing-file.txt
+* ```
+*
+* @since 4.0.0
+* @category constructors
+*/
+const file$2 = (kind, name, options) => path$1(kind, name, {
+	pathType: "file",
+	typeName: "file",
+	mustExist: options?.mustExist
+});
+/**
 * Creates an empty sentinel parameter that always fails to parse.
 *
 * This is useful for creating placeholder parameters or for combinators.
@@ -51323,6 +51352,26 @@ const choiceWithValue = (name, choices) => choiceWithValue$1(flagKind, name, cho
 */
 const choice = (name, choices) => choice$1(flagKind, name, choices);
 /**
+* Creates a file path flag that accepts file paths with optional existence validation.
+*
+* @example
+* ```ts
+* import { Flag } from "effect/unstable/cli"
+*
+* // Basic file flag
+* const inputFlag = Flag.file("input")
+* // Usage: --input ./data.json
+*
+* // File that must exist
+* const configFlag = Flag.file("config", { mustExist: true })
+* // Usage: --config ./config.yaml (file must exist)
+* ```
+*
+* @since 4.0.0
+* @category constructors
+*/
+const file$1 = (name, options) => file$2(flagKind, name, options);
+/**
 * Creates a directory path flag that accepts directory paths with optional existence validation.
 *
 * @example
@@ -155771,11 +155820,18 @@ var Editor = class extends Service$1()("lalph/Editor", { make: gen(function* ()
 //#region src/commands/plan.ts
 const dangerous = boolean("dangerous").pipe(withAlias("d"), withDescription$1("Skip permission prompts while generating the specification from your plan"));
 const withNewProject = boolean("new").pipe(withAlias("n"), withDescription$1("Create a new project (via prompts) before starting plan mode"));
+const file = file$1("file", { mustExist: true }).pipe(withAlias("f"), withDescription$1("Read the plan from a markdown file instead of opening an editor"), optional);
 const commandPlan = make$36("plan", {
 	dangerous,
-	withNewProject
-}).pipe(withDescription("Open an editor to draft a plan; on save, generate a specification under --specs and then create PRD tasks from it. Use --new to create a project first; use --dangerous to skip permission prompts during spec generation."), withHandler(fnUntraced(function* ({ dangerous, withNewProject }) {
-	const thePlan = yield* (yield* Editor).editTemp({ suffix: ".md" });
+	withNewProject,
+	file
+}).pipe(withDescription("Draft a plan in your editor (or use --file); then generate a specification under --specs and create PRD tasks from it. Use --new to create a project first, and --dangerous to skip permission prompts during spec generation."), withHandler(fnUntraced(function* ({ dangerous, withNewProject, file }) {
+	const editor = yield* Editor;
+	const fs = yield* FileSystem;
+	const thePlan = yield* matchEffect(file.asEffect(), {
+		onFailure: () => editor.editTemp({ suffix: ".md" }),
+		onSuccess: (path) => fs.readFileString(path).pipe(asSome)
+	});
 	if (isNone(thePlan)) return;
 	yield* gen(function* () {
 		const project = withNewProject ? yield* addOrUpdateProject() : yield* selectProject;
@@ -155916,7 +155972,7 @@ const commandSource = make$36("source").pipe(withDescription("Select the issue s
 
 //#endregion
 //#region package.json
-var version = "0.3.24";
+var version = "0.3.25";
 
 //#endregion
 //#region src/commands/projects/ls.ts

package/package.json

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

package/src/commands/plan.ts

@@ -29,20 +29,32 @@ const withNewProject = Flag.boolean("new").pipe(
   ),
 )
 
+const file = Flag.file("file", { mustExist: true }).pipe(
+  Flag.withAlias("f"),
+  Flag.withDescription(
+    "Read the plan from a markdown file instead of opening an editor",
+  ),
+  Flag.optional,
+)
+
 export const commandPlan = Command.make("plan", {
   dangerous,
   withNewProject,
+  file,
 }).pipe(
   Command.withDescription(
-    "Open an editor to draft a plan; on save, generate a specification under --specs and then create PRD tasks from it. Use --new to create a project first; use --dangerous to skip permission prompts during spec generation.",
+    "Draft a plan in your editor (or use --file); then generate a specification under --specs and create PRD tasks from it. Use --new to create a project first, and --dangerous to skip permission prompts during spec generation.",
   ),
   Command.withHandler(
-    Effect.fnUntraced(function* ({ dangerous, withNewProject }) {
+    Effect.fnUntraced(function* ({ dangerous, withNewProject, file }) {
       const editor = yield* Editor
+      const fs = yield* FileSystem.FileSystem
 
-      const thePlan = yield* editor.editTemp({
-        suffix: ".md",
+      const thePlan = yield* Effect.matchEffect(file.asEffect(), {
+        onFailure: () => editor.editTemp({ suffix: ".md" }),
+        onSuccess: (path) => fs.readFileString(path).pipe(Effect.asSome),
       })
+
       if (Option.isNone(thePlan)) return
 
       // We nest this effect, so we can launch the editor first as fast as