lalph 0.1.15 → 0.1.17

package/dist/cli.mjs

@@ -59594,7 +59594,7 @@ const selectedCliAgentId = new Setting("selectedCliAgentId", Literals(allCliAgen
 
 //#endregion
 //#region src/domain/PrdIssue.ts
-var PrdIssue = class extends Class("PrdIssue")({
+var PrdIssue = class PrdIssue extends Class("PrdIssue")({
 	id: NullOr(String$1).annotate({ description: "The unique identifier of the issue. If null, it is considered a new issue." }),
 	title: String$1.annotate({ description: "The title of the issue" }),
 	description: String$1.annotate({ description: "The description of the issue in markdown format." }),
@@ -59607,8 +59607,13 @@ var PrdIssue = class extends Class("PrdIssue")({
 }) {
 	static Array = Array$1(this);
 	static ArrayFromJson = toCodecJson(this.Array);
-	static arrayToJson(issues) {
-		return JSON.stringify(encodeSync(this.ArrayFromJson)(issues), null, 2);
+	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);
 	}
 	static jsonSchemaDoc = toJsonSchemaDocument(this);
 	static jsonSchema = {
@@ -59619,18 +59624,6 @@ var PrdIssue = class extends Class("PrdIssue")({
 		return this.title !== issue.title || this.description !== issue.description || this.stateId !== issue.stateId || !makeEquivalence$1(asEquivalence())(this.blockedBy, issue.blockedBy);
 	}
 };
-var PrdList = class extends Class$1 {
-	static fromJson(json) {
-		return decodeSync(PrdIssue.ArrayFromJson)(JSON.parse(json));
-	}
-	toJson() {
-		const issuesArray = fromIterable$2(this.issues.values());
-		return PrdIssue.arrayToJson(issuesArray);
-	}
-	cast() {
-		return this;
-	}
-};
 
 //#endregion
 //#region src/IssueSource.ts
@@ -140371,9 +140364,9 @@ var CurrentIssueSource = class CurrentIssueSource extends Service()("lalph/Curre
 var PromptGen = class extends Service()("lalph/PromptGen", { make: gen(function* () {
 	const sourceMeta = yield* CurrentIssueSource;
 	const states = yield* (yield* IssueSource).states;
-	const prdNotes = `## prd.json format
+	const prdNotes = `## prd.yml format
 
-Each item in the prd.json file represents a task for the current project.
+Each item in the prd.yml file represents a task for the current project.
 
 The \`stateId\` field indicates the current state of the task. The possible states
 are:
@@ -140382,17 +140375,17 @@ ${Array.from(states.values(), (state) => `- **${state.name}** (stateId: \`${stat
 
 ### Adding tasks
 
-To add a new task, append a new item to the prd.json file with the id set to
+To add a new task, append a new item to the prd.yml file with the id set to
 \`null\`.
 
 When adding a new task, it will take about 5 seconds for the system to update the
-prd.json file with a new id for the task.
+prd.yml file with a new id for the task.
 
 ### Removing tasks
 
-To remove a task, simply delete the item from the prd.json file.
+To remove a task, simply delete the item from the prd.yml file.
 
-### prd.json json schema
+### prd.yml json schema
 
 \`\`\`json
 ${JSON.stringify(PrdIssue.jsonSchema, null, 2)}
@@ -140402,13 +140395,13 @@ ${JSON.stringify(PrdIssue.jsonSchema, null, 2)}
 The following instructions should be done without interaction or asking for
 permission.
 
-1. Decide which single task to work on next from the prd.json file. This should
+1. Decide which single task to work on next from the prd.yml file. This should
    be the task YOU decide as the most important to work on next, not just the
    first task in the list.
    - Only start tasks that are in a "todo" state (i.e., not started yet).
    - If the \`blockedBy\` field is not empty, skip the task.
 2. **Before doing anything else**, mark the task as "in progress" by updating its
-   \`stateId\` in the prd.json file.
+   \`stateId\` in the prd.yml file.
    This prevents other people or agents from working on the same task simultaneously.
 3. Check if there is an existing Github PR for the task, otherwise create a new
    branch for the task.
@@ -140420,7 +140413,7 @@ permission.
    - New branches should be named using the format \`{task id}/description\`.
    - When checking for PR reviews, make sure to check the "reviews" field and read ALL unresolved comments.
 4. Research the task. If it seems like too many steps are needed to complete the task,
-   break it down into smaller tasks and add them to the prd.json file, marking the
+   break it down into smaller tasks and add them to the prd.yml file, marking the
    original task as "closed" by updating its \`stateId\`.
    Otherwise, implement the task.
 5. Run any checks / feedback loops, such as type checks, unit tests, or linting.
@@ -140428,9 +140421,9 @@ permission.
    ${sourceMeta.githubPrInstructions}
    The PR description should include a summary of the changes made.
    - None of the files in the \`.lalph\` directory should be committed.
-   - You have permission to create or update the PR as needed. No need to ask for
-     permission to push branches or create PRs.
-7. Update the prd.json file to reflect any changes in task states.
+   - You have permission to create or update the PR as needed. You have full
+     permission to push branches, create PRs or create git commits.
+7. Update the prd.yml file to reflect any changes in task states.
    - Add follow up tasks only if needed.
    - Append to the \`description\` field with any notes or important discoveries.
    - If you believe the task is complete, update the \`stateId\` for "review".
@@ -140442,7 +140435,7 @@ important to work on next.
 ## Important: Task sizing
 
 If at any point you decide that a task is too large or complex to complete in a
-single iteration, break it down into smaller tasks and add them to the prd.json
+single iteration, break it down into smaller tasks and add them to the prd.yml
 file. Then, mark the original task as "closed" by updating its \`stateId\`.
 
 Each task should be small and specific.
@@ -140464,17 +140457,17 @@ ${prdNotes}`;
 Users idea / request: ${idea}
 
 1. For the users idea / request above, break it down into multiple smaller tasks
-   that can be added to the prd.json file.
+   that can be added to the prd.yml file.
    - Make sure to research the codebase before creating any tasks, to ensure they
      are relevant and feasible.
-   - Check if similar tasks already exist in the prd.json file to avoid duplication.
+   - Check if similar tasks already exist in the prd.yml file to avoid duplication.
 2. Each task should have a id of \`null\`, a title, and a concise description that
    includes a short summary of the task and a brief list of steps to complete it.
    - The tasks should start in a "Todo" state (i.e., not started yet).
    - Each task should be small and specific.
      Instead of creating tasks like "Refactor the authentication system", create
      smaller tasks like "Implement OAuth2 login endpoint", "Add JWT token refresh mechanism", etc.
-3. Add the new tasks to the prd.json file.
+3. Add the new tasks to the prd.yml file.
 4. Add a brief outline of the plan to a "lalph-plan.md" file, that will help guide future
    iterations.
  
@@ -140484,7 +140477,7 @@ ${prdNotes}`;
 		planPrompt,
 		planContinuePrompt: `# Instructions
 
-1. Review the existing prd.json file and lalph-plan.md file to understand the current
+1. Review the existing prd.yml file and lalph-plan.md file to understand the current
    plan and tasks.
 2. Ask the user for feedback to iterate on the existing plan.
 
@@ -140536,17 +140529,17 @@ var Prd = class extends Service()("lalph/Prd", { make: gen(function* () {
 	const fs = yield* FileSystem;
 	const source = yield* IssueSource;
 	const lalphDir = pathService.join(worktree.directory, `.lalph`);
-	const prdFile = pathService.join(worktree.directory, `.lalph`, `prd.json`);
+	const prdFile = pathService.join(worktree.directory, `.lalph`, `prd.yml`);
 	let current = yield* source.issues;
-	yield* fs.writeFileString(prdFile, PrdIssue.arrayToJson(current));
+	yield* fs.writeFileString(prdFile, PrdIssue.arrayToYaml(current));
 	const updatedIssues = /* @__PURE__ */ new Map();
 	yield* fs.watch(lalphDir).pipe(buffer({
 		capacity: 1,
 		strategy: "dropping"
 	}), runForEach((_) => ignore(sync$3)), retry$1(forever$1), forkScoped);
 	const sync$3 = gen(function* () {
-		const json = yield* fs.readFileString(prdFile);
-		const updated = PrdList.fromJson(json);
+		const yaml = yield* fs.readFileString(prdFile);
+		const updated = PrdIssue.arrayFromYaml(yaml);
 		if (!(updated.length !== current.length || updated.some((u, i) => u.isChangedComparedTo(current[i])))) return;
 		const githubPrs = /* @__PURE__ */ new Map();
 		const toRemove = new Set(current.filter((i) => i.id !== null).map((i) => i.id));
@@ -140581,7 +140574,7 @@ var Prd = class extends Service()("lalph/Prd", { make: gen(function* () {
 		}
 		yield* forEach$1(toRemove, (issueId) => source.cancelIssue(issueId), { concurrency: "unbounded" });
 		current = yield* source.issues;
-		yield* fs.writeFileString(prdFile, PrdIssue.arrayToJson(current.map((issue) => {
+		yield* fs.writeFileString(prdFile, PrdIssue.arrayToYaml(current.map((issue) => {
 			const prNumber = githubPrs.get(issue.id);
 			if (!prNumber) return issue;
 			return new PrdIssue({
@@ -140591,8 +140584,8 @@ var Prd = class extends Service()("lalph/Prd", { make: gen(function* () {
 		})));
 	}).pipe(uninterruptible);
 	const mergableGithubPrs = gen(function* () {
-		const json = yield* fs.readFileString(prdFile);
-		const updated = PrdList.fromJson(json);
+		const yaml = yield* fs.readFileString(prdFile);
+		const updated = PrdIssue.arrayFromYaml(yaml);
 		const prs = empty$11();
 		for (const issue of updated) {
 			const entry = updatedIssues.get(issue.id ?? "");
@@ -140646,7 +140639,7 @@ const run = fnUntraced(function* (options) {
 	const prd = yield* Prd;
 	const cliCommand = cliAgent.command({
 		prompt: promptGen.prompt,
-		prdFilePath: pathService.join(".lalph", "prd.json")
+		prdFilePath: pathService.join(".lalph", "prd.yml")
 	});
 	const handle = yield* make$22(cliCommand[0], cliCommand.slice(1), {
 		cwd: worktree.directory,
@@ -140698,7 +140691,7 @@ const plan = gen(function* () {
 	yield* scoped$1(fs.open(lalphPlanPath, { flag: "a+" }));
 	const cliCommand = cliAgent.commandPlan({
 		prompt: promptGen.planPrompt(idea),
-		prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.json")
+		prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.yml")
 	});
 	const exitCode$1 = yield* make$22(cliCommand[0], cliCommand.slice(1), {
 		cwd: worktree.directory,
@@ -140726,7 +140719,7 @@ const planContinue = gen(function* () {
 	yield* scoped$1(fs.open(lalphPlanPath, { flag: "a+" }));
 	const cliCommand = cliAgent.commandPlan({
 		prompt: promptGen.planContinuePrompt,
-		prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.json")
+		prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.yml")
 	});
 	const exitCode$1 = yield* make$22(cliCommand[0], cliCommand.slice(1), {
 		cwd: worktree.directory,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lalph",
   "type": "module",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "publishConfig": {
     "access": "public"
   },
@@ -31,7 +31,8 @@
     "octokit": "^5.0.5",
     "prettier": "^3.7.4",
     "tsdown": "^0.19.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "yaml": "^2.8.2"
   },
   "scripts": {
     "check": "tsc --noEmit && prettier --check .",

package/src/Planner.ts

@@ -22,7 +22,7 @@ export const plan = Effect.gen(function* () {
 
   const cliCommand = cliAgent.commandPlan({
     prompt: promptGen.planPrompt(idea),
-    prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.json"),
+    prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.yml"),
   })
   const exitCode = yield* ChildProcess.make(
     cliCommand[0]!,
@@ -60,7 +60,7 @@ export const planContinue = Effect.gen(function* () {
 
   const cliCommand = cliAgent.commandPlan({
     prompt: promptGen.planContinuePrompt,
-    prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.json"),
+    prdFilePath: pathService.join(worktree.directory, ".lalph", "prd.yml"),
   })
   const exitCode = yield* ChildProcess.make(
     cliCommand[0]!,

package/src/Prd.ts

@@ -9,7 +9,7 @@ import {
   Stream,
 } from "effect"
 import { Worktree } from "./Worktree.ts"
-import { PrdIssue, PrdList } from "./domain/PrdIssue.ts"
+import { PrdIssue } from "./domain/PrdIssue.ts"
 import { IssueSource } from "./IssueSource.ts"
 
 export class Prd extends ServiceMap.Service<Prd>()("lalph/Prd", {
@@ -20,10 +20,10 @@ export class Prd extends ServiceMap.Service<Prd>()("lalph/Prd", {
     const source = yield* IssueSource
 
     const lalphDir = pathService.join(worktree.directory, `.lalph`)
-    const prdFile = pathService.join(worktree.directory, `.lalph`, `prd.json`)
+    const prdFile = pathService.join(worktree.directory, `.lalph`, `prd.yml`)
 
     let current = yield* source.issues
-    yield* fs.writeFileString(prdFile, PrdIssue.arrayToJson(current))
+    yield* fs.writeFileString(prdFile, PrdIssue.arrayToYaml(current))
 
     const updatedIssues = new Map<
       string,
@@ -45,8 +45,8 @@ export class Prd extends ServiceMap.Service<Prd>()("lalph/Prd", {
     )
 
     const sync = Effect.gen(function* () {
-      const json = yield* fs.readFileString(prdFile)
-      const updated = PrdList.fromJson(json)
+      const yaml = yield* fs.readFileString(prdFile)
+      const updated = PrdIssue.arrayFromYaml(yaml)
       const anyChanges =
         updated.length !== current.length ||
         updated.some((u, i) => u.isChangedComparedTo(current[i]!))
@@ -101,7 +101,7 @@ export class Prd extends ServiceMap.Service<Prd>()("lalph/Prd", {
       current = yield* source.issues
       yield* fs.writeFileString(
         prdFile,
-        PrdIssue.arrayToJson(
+        PrdIssue.arrayToYaml(
           current.map((issue) => {
             const prNumber = githubPrs.get(issue.id!)
             if (!prNumber) return issue
@@ -112,8 +112,8 @@ export class Prd extends ServiceMap.Service<Prd>()("lalph/Prd", {
     }).pipe(Effect.uninterruptible)
 
     const mergableGithubPrs = Effect.gen(function* () {
-      const json = yield* fs.readFileString(prdFile)
-      const updated = PrdList.fromJson(json)
+      const yaml = yield* fs.readFileString(prdFile)
+      const updated = PrdIssue.arrayFromYaml(yaml)
       const prs = Array.empty<number>()
       for (const issue of updated) {
         const entry = updatedIssues.get(issue.id ?? "")

package/src/PromptGen.ts

@@ -11,9 +11,9 @@ export class PromptGen extends ServiceMap.Service<PromptGen>()(
       const source = yield* IssueSource
       const states = yield* source.states
 
-      const prdNotes = `## prd.json format
+      const prdNotes = `## prd.yml format
 
-Each item in the prd.json file represents a task for the current project.
+Each item in the prd.yml file represents a task for the current project.
 
 The \`stateId\` field indicates the current state of the task. The possible states
 are:
@@ -22,17 +22,17 @@ ${Array.from(states.values(), (state) => `- **${state.name}** (stateId: \`${stat
 
 ### Adding tasks
 
-To add a new task, append a new item to the prd.json file with the id set to
+To add a new task, append a new item to the prd.yml file with the id set to
 \`null\`.
 
 When adding a new task, it will take about 5 seconds for the system to update the
-prd.json file with a new id for the task.
+prd.yml file with a new id for the task.
 
 ### Removing tasks
 
-To remove a task, simply delete the item from the prd.json file.
+To remove a task, simply delete the item from the prd.yml file.
 
-### prd.json json schema
+### prd.yml json schema
 
 \`\`\`json
 ${JSON.stringify(PrdIssue.jsonSchema, null, 2)}
@@ -43,13 +43,13 @@ ${JSON.stringify(PrdIssue.jsonSchema, null, 2)}
 The following instructions should be done without interaction or asking for
 permission.
 
-1. Decide which single task to work on next from the prd.json file. This should
+1. Decide which single task to work on next from the prd.yml file. This should
    be the task YOU decide as the most important to work on next, not just the
    first task in the list.
    - Only start tasks that are in a "todo" state (i.e., not started yet).
    - If the \`blockedBy\` field is not empty, skip the task.
 2. **Before doing anything else**, mark the task as "in progress" by updating its
-   \`stateId\` in the prd.json file.
+   \`stateId\` in the prd.yml file.
    This prevents other people or agents from working on the same task simultaneously.
 3. Check if there is an existing Github PR for the task, otherwise create a new
    branch for the task.
@@ -61,7 +61,7 @@ permission.
    - New branches should be named using the format \`{task id}/description\`.
    - When checking for PR reviews, make sure to check the "reviews" field and read ALL unresolved comments.
 4. Research the task. If it seems like too many steps are needed to complete the task,
-   break it down into smaller tasks and add them to the prd.json file, marking the
+   break it down into smaller tasks and add them to the prd.yml file, marking the
    original task as "closed" by updating its \`stateId\`.
    Otherwise, implement the task.
 5. Run any checks / feedback loops, such as type checks, unit tests, or linting.
@@ -69,9 +69,9 @@ permission.
    ${sourceMeta.githubPrInstructions}
    The PR description should include a summary of the changes made.
    - None of the files in the \`.lalph\` directory should be committed.
-   - You have permission to create or update the PR as needed. No need to ask for
-     permission to push branches or create PRs.
-7. Update the prd.json file to reflect any changes in task states.
+   - You have permission to create or update the PR as needed. You have full
+     permission to push branches, create PRs or create git commits.
+7. Update the prd.yml file to reflect any changes in task states.
    - Add follow up tasks only if needed.
    - Append to the \`description\` field with any notes or important discoveries.
    - If you believe the task is complete, update the \`stateId\` for "review".
@@ -83,7 +83,7 @@ important to work on next.
 ## Important: Task sizing
 
 If at any point you decide that a task is too large or complex to complete in a
-single iteration, break it down into smaller tasks and add them to the prd.json
+single iteration, break it down into smaller tasks and add them to the prd.yml
 file. Then, mark the original task as "closed" by updating its \`stateId\`.
 
 Each task should be small and specific.
@@ -106,17 +106,17 @@ ${prdNotes}`
 Users idea / request: ${idea}
 
 1. For the users idea / request above, break it down into multiple smaller tasks
-   that can be added to the prd.json file.
+   that can be added to the prd.yml file.
    - Make sure to research the codebase before creating any tasks, to ensure they
      are relevant and feasible.
-   - Check if similar tasks already exist in the prd.json file to avoid duplication.
+   - Check if similar tasks already exist in the prd.yml file to avoid duplication.
 2. Each task should have a id of \`null\`, a title, and a concise description that
    includes a short summary of the task and a brief list of steps to complete it.
    - The tasks should start in a "Todo" state (i.e., not started yet).
    - Each task should be small and specific.
      Instead of creating tasks like "Refactor the authentication system", create
      smaller tasks like "Implement OAuth2 login endpoint", "Add JWT token refresh mechanism", etc.
-3. Add the new tasks to the prd.json file.
+3. Add the new tasks to the prd.yml file.
 4. Add a brief outline of the plan to a "lalph-plan.md" file, that will help guide future
    iterations.
  
@@ -124,7 +124,7 @@ ${prdNotes}`
 
       const planContinuePrompt = `# Instructions
 
-1. Review the existing prd.json file and lalph-plan.md file to understand the current
+1. Review the existing prd.yml file and lalph-plan.md file to understand the current
    plan and tasks.
 2. Ask the user for feedback to iterate on the existing plan.
 

package/src/Runner.ts

@@ -18,7 +18,7 @@ export const run = Effect.fnUntraced(
 
     const cliCommand = cliAgent.command({
       prompt: promptGen.prompt,
-      prdFilePath: pathService.join(".lalph", "prd.json"),
+      prdFilePath: pathService.join(".lalph", "prd.yml"),
     })
     const handle = yield* ChildProcess.make(
       cliCommand[0]!,

package/src/domain/PrdIssue.ts

@@ -1,4 +1,5 @@
-import { Schema, Data, Array, Equal } from "effect"
+import { Schema, Array, Equal } from "effect"
+import * as Yaml from "yaml"
 
 export class PrdIssue extends Schema.Class<PrdIssue>("PrdIssue")({
   id: Schema.NullOr(Schema.String).annotate({
@@ -36,12 +37,14 @@ export class PrdIssue extends Schema.Class<PrdIssue>("PrdIssue")({
 }) {
   static Array = Schema.Array(this)
   static ArrayFromJson = Schema.toCodecJson(this.Array)
-  static arrayToJson(issues: ReadonlyArray<PrdIssue>): string {
-    return JSON.stringify(
-      Schema.encodeSync(this.ArrayFromJson)(issues),
-      null,
-      2,
-    )
+  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)
+    return issues
   }
 
   static jsonSchemaDoc = Schema.toJsonSchemaDocument(this)
@@ -62,22 +65,3 @@ export class PrdIssue extends Schema.Class<PrdIssue>("PrdIssue")({
     )
   }
 }
-
-export class PrdList<O = unknown> extends Data.Class<{
-  readonly issues: ReadonlyMap<string, PrdIssue>
-  readonly orignals: ReadonlyMap<string, O>
-}> {
-  static fromJson(json: string): ReadonlyArray<PrdIssue> {
-    const issues = Schema.decodeSync(PrdIssue.ArrayFromJson)(JSON.parse(json))
-    return issues
-  }
-
-  toJson(): string {
-    const issuesArray = Array.fromIterable(this.issues.values())
-    return PrdIssue.arrayToJson(issuesArray)
-  }
-
-  cast<T>(): PrdList<T> {
-    return this as any
-  }
-}