lalph 0.3.61 → 0.3.62

package/dist/cli.mjs

@@ -87793,6 +87793,7 @@ var Project$2 = class extends Class$1("lalph/Project")({
 	targetBranch: Option(String$1),
 	concurrency: Int.check(isGreaterThanOrEqualTo(1)),
 	gitFlow: Literals(["pr", "commit"]),
+	researchAgent: Boolean$2.pipe(withDecodingDefault(() => false)),
 	reviewAgent: Boolean$2
 }) {};
 //#endregion
@@ -177948,7 +177949,7 @@ var ji = Bt, Ii = Object.assign(Qe, { sync: Bt }), zi = Ut, Bi = Object.assign(e
 });
 Ze.glob = Ze;
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/ApplyPatch.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/ApplyPatch.js
 /**
 * @since 1.0.0
 */
@@ -192821,7 +192822,7 @@ var StreamableHTTPClientTransport = class {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/McpClient.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/McpClient.js
 /**
 * @since 1.0.0
 */
@@ -192866,7 +192867,7 @@ const layer$7 = effect$1(McpClient, gen(function* () {
 	});
 }));
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/ExaSearch.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/ExaSearch.js
 /**
 * @since 1.0.0
 */
@@ -207816,7 +207817,7 @@ var require_lib = /* @__PURE__ */ __commonJSMin$1(((exports) => {
 	exports.impl = impl;
 }));
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/WebToMarkdown.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/WebToMarkdown.js
 /**
 * @since 1.0.0
 */
@@ -210898,7 +210899,7 @@ const unsafeSecureJsonParse = (text) => {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/AgentTools.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/AgentTools.js
 /**
 * @since 1.0.0
 */
@@ -211248,7 +211249,7 @@ const AgentToolHandlers = AgentToolHandlersNoDeps.pipe(provide$3([layer$6, layer
 AgentToolHandlersNoDeps.pipe(provide$3([mock(ExaSearch)({}), mock(WebToMarkdown)({})]));
 var ApplyPatchError = class extends TaggedClass$1("ApplyPatchError") {};
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/TypeBuilder.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/TypeBuilder.js
 const resolveDocumentation = resolveAt("documentation");
 const identifierPattern = /^[$A-Z_a-z][$0-9A-Z_a-z]*$/u;
 const Precedence = {
@@ -211521,7 +211522,7 @@ const render = (schema, options) => {
 	return printNode({ text: documentation === void 0 ? rendered.text : `${renderJsDoc(documentation, 0, printerOptions)}${printerOptions.newLine}${rendered.text}` }, printerOptions);
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/ToolkitRenderer.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/ToolkitRenderer.js
 /**
 * @since 1.0.0
 */
@@ -211543,7 +211544,7 @@ declare function ${name}(${params}): Promise<${render(tool.successSchema)}>`);
 	}) });
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/AgentExecutor.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/AgentExecutor.js
 /**
 * @since 1.0.0
 */
@@ -211697,7 +211698,7 @@ var QueueWriteStream = class extends Writable {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/ScriptExtraction.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/ScriptExtraction.js
 const stripWrappingCodeFence = (script) => {
 	const lines = script.split(/\r?\n/);
 	if (lines.length < 2) return script;
@@ -213080,7 +213081,7 @@ const applySpanTransformer = (transformer, response, options) => {
 	});
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/Agent.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/Agent.js
 /**
 * @since 1.0.0
 */
@@ -213230,7 +213231,7 @@ ${content}
 					const result = yield* executeScript(currentScript);
 					update(prompt, concat([{
 						role: modelConfig.supportsAssistantPrefill ? "assistant" : "user",
-						content: `Javascript output:\n\n${result}`
+						content: `Console output from executing javascript code:\n\n${result}`
 					}]));
 					currentScript = "";
 				}
@@ -213409,7 +213410,8 @@ ${options.agentsMd}
 const generateSystemTools = (toolsDts, multi) => {
 	return `${multi ? generateSystemMulti(toolsDts) : generateSystemSingle(toolsDts)}
 
-Here is how you would read a file:
+For example, here is how you would read a file. First you would respond with
+javascript code that uses the "readFile" function:
 
 \`\`\`
 const content = await readFile({
@@ -213420,10 +213422,10 @@ const content = await readFile({
 console.log(JSON.parse(content))
 \`\`\`
 
-And the output would look like this:
+And then you will revieve back the console output:
 
 \`\`\`
-Javascript output:
+Console output from executing javascript code:
 
 [22:44:53.054] INFO (#47): Calling "readFile" { path: 'package.json' }
 {
@@ -213446,10 +213448,12 @@ const systemToolsCommon = (toolsDts) => `- Use \`console.log\` to print any outp
 - Top level await is supported.
 - AVOID passing scripts into the "bash" function, and instead write javascript.
 - PREFER the "search" function over "rg" for finding information or code
+- Do as much work as possible in a single script, using \`Promise.all\` to run multiple functions in parallel.
 - Variables **are not shared** between executions, so you must include all necessary code in each script you execute.
 - Make use of the "delegate" tool to delegate exploration and small research tasks. You can delegate multiple tasks in parallel with Promise.all
 
 **When you have fully completed your task**, call the "taskComplete" function with the final output.
+DO NOT output the final result without wrapping it with "taskComplete".
 Make sure every detail of the task is done before calling "taskComplete".
 
 You have the following functions available to you:
@@ -224220,7 +224224,7 @@ const transformToolCallParams = /* @__PURE__ */ fnUntraced(function* (tools, too
 	})));
 });
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/CodexAuth.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/CodexAuth.js
 /**
 * @since 1.0.0
 */
@@ -224440,7 +224444,7 @@ var CodexAuth = class CodexAuth extends Service$1()("clanka/CodexAuth") {
 	static layerClient = this.layerClientNoDeps.pipe(provide$3(CodexAuth.layer));
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/Codex.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/Codex.js
 /**
 * @since 1.0.0
 */
@@ -225759,7 +225763,7 @@ const getUsageDetailNumber = (details, field) => {
 	return typeof value === "number" ? value : void 0;
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/CopilotAuth.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/CopilotAuth.js
 /**
 * @since 1.0.0
 */
@@ -225950,7 +225954,7 @@ var GithubCopilotAuth = class GithubCopilotAuth extends Service$1()("clanka/Gith
 	static layerClient = this.layerClientNoDeps.pipe(provide$3(GithubCopilotAuth.layer));
 };
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/Copilot.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/Copilot.js
 /**
 * @since 1.0.0
 */
@@ -226373,7 +226377,7 @@ Object.defineProperties(createChalk.prototype, styles);
 const chalk = createChalk();
 createChalk({ level: stderrColor ? stderrColor.level : 0 });
 //#endregion
-//#region node_modules/.pnpm/clanka@0.1.8_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-op_c1c0d9126463b1cd141896b41f79abdf/node_modules/clanka/dist/OutputFormatter.js
+//#region node_modules/.pnpm/clanka@0.1.10_@effect+ai-openai-compat@4.0.0-beta.31_effect@4.0.0-beta.31__@effect+ai-o_9214219cb2db90147f00f2a3436d6c48/node_modules/clanka/dist/OutputFormatter.js
 /**
 * @since 1.0.0
 */
@@ -234123,6 +234127,21 @@ All steps must be done before the task can be considered complete.${options.task
 5. **After ${options.gitFlow.requiresGithubPr ? "pushing" : "committing"}** your changes, update current task to reflect any changes in the task state.
    - Rewrite the notes in the description to include only the key discoveries and information that could speed up future work on other tasks. Make sure to preserve important information such as specification file references.
    - If you believe the task is complete, update the \`state\` to "in-review".`;
+	const promptResearch = (options) => `Your job is to gather all the necessary information and details to complete the task described below. Do not make any code changes yet, your job is just to research and gather information.
+
+In the final report:
+
+- Include key file names, line numbers, and code snippets that are relevant to the task.
+- Any key discoveries that will help with implementing the task.
+- Any other information that will help speed up the implementation of the task.
+- You DO NOT need to add your report to the task description, just include it in your final output.
+
+# Task details
+
+ID: ${options.task.id}
+Title: ${options.task.title}
+
+${options.task.description}`;
 	const promptReview = (options) => `A previous engineer has completed a task from the instructions below.
 
 You job is to meticulously review their work to ensure it meets the task requirements,
@@ -234268,6 +234287,7 @@ Make sure to setup dependencies between the tasks using the \`blockedBy\` field.
 		promptChooseClanka,
 		prompt,
 		promptClanka,
+		promptResearch,
 		promptReview,
 		promptReviewCustom,
 		promptTimeout,
@@ -234437,6 +234457,10 @@ const addOrUpdateProject = fnUntraced(function* (existing) {
 			selected: existing ? existing.gitFlow === "commit" : false
 		}]
 	});
+	const researchAgent = yield* toggle({
+		message: "Enable research agent?",
+		initial: existing ? existing.researchAgent : true
+	});
 	const reviewAgent = yield* toggle({
 		message: "Enable review agent?",
 		initial: existing ? existing.reviewAgent : true
@@ -234447,6 +234471,7 @@ const addOrUpdateProject = fnUntraced(function* (existing) {
 		concurrency,
 		targetBranch,
 		gitFlow,
+		researchAgent,
 		reviewAgent
 	});
 	yield* Settings.set(allProjects, some$2(existing ? projects.map((p) => p.id === project.id ? project : p) : [...projects, project]));
@@ -234900,7 +234925,7 @@ const runClanka = fnUntraced(function* (options) {
 		yield* log$1(`Received steer message: ${message}`);
 		yield* agent.steer(message);
 	}, fromEffectDrain)), runDrain, forkScoped);
-	yield* stream.pipe(runDrain, catchTag$1("AgentFinished", () => void_$1));
+	return yield* stream.pipe(runDrain, as$1(""), catchTag$1("AgentFinished", (e) => succeed$3(e.summary)));
 }, scoped$1, (effect, options) => provide$1(effect, layerLocal({
 	directory: options.directory,
 	tools: options.withChoose ? TaskChooseTools : TaskTools
@@ -234915,7 +234940,18 @@ const agentWorker = fnUntraced(function* (options) {
 			directory: worktree.directory,
 			model: options.preset.extraArgs.join(" "),
 			system: options.system,
-			prompt: options.prompt,
+			prompt: match$8(options.research, {
+				onNone: () => options.prompt,
+				onSome: (research) => make$7([{
+					role: "user",
+					content: options.prompt
+				}, {
+					role: "assistant",
+					content: `Another software engineer has done some prior research for this task, and found the following information:
+
+${research}`
+				}])
+			}),
 			stallTimeout: options.stallTimeout,
 			steer: options.steer
 		});
@@ -235160,6 +235196,20 @@ const agentTimeout = fnUntraced(function* (options) {
 	}));
 });
 //#endregion
+//#region src/Agents/researcher.ts
+const agentResearcher = fnUntraced(function* (options) {
+	const worktree = yield* Worktree;
+	const promptGen = yield* PromptGen;
+	if (options.preset.cliAgent.command) return none$4();
+	return yield* runClanka({
+		directory: worktree.directory,
+		model: options.preset.extraArgs.join(" "),
+		system: promptGen.systemClanka(options),
+		prompt: promptGen.promptResearch({ task: options.task }),
+		stallTimeout: options.stallTimeout
+	}).pipe(asSome);
+});
+//#endregion
 //#region src/commands/root.ts
 const run = fnUntraced(function* (options) {
 	const projectId = yield* CurrentProjectId;
@@ -235223,6 +235273,13 @@ const run = fnUntraced(function* (options) {
 	}));
 	if (yield* gen(function* () {
 		registry.update(currentWorker.state, (s) => s.transitionTo(WorkerStatus.Working({ issueId: taskId })));
+		let researchResult = none$4();
+		if (options.research) researchResult = yield* agentResearcher({
+			task: chosenTask.prd,
+			specsDirectory: options.specsDirectory,
+			stallTimeout: options.stallTimeout,
+			preset: taskPreset
+		});
 		const promptGen = yield* PromptGen;
 		const instructions = taskPreset.cliAgent.command ? promptGen.prompt({
 			specsDirectory: options.specsDirectory,
@@ -235246,6 +235303,7 @@ const run = fnUntraced(function* (options) {
 			stallTimeout: options.stallTimeout,
 			preset: taskPreset,
 			prompt: instructions,
+			research: researchResult,
 			steer
 		}).pipe(provideService$2(CurrentTaskRef, issueRef), catchStallInReview, withSpan("Main.agentWorker"))}`);
 		if (options.review) {
@@ -235297,7 +235355,8 @@ const runProject = fnUntraced(function* (options) {
 			specsDirectory: options.specsDirectory,
 			stallTimeout: options.stallTimeout,
 			runTimeout: options.runTimeout,
-			review: options.project.reviewAgent
+			review: options.project.reviewAgent,
+			research: options.project.researchAgent
 		}).pipe(provide$1(options.project.gitFlow === "commit" ? GitFlowCommit : GitFlowPR, { local: true }), withWorkerState(options.project.id))), catchTags$1({
 			NoMoreWork(_error) {
 				if (isFinite) {
@@ -235359,10 +235418,10 @@ const commandRoot = make$49("lalph", {
 const watchTaskState = fnUntraced(function* (options) {
 	return yield* toStreamResult(yield* AtomRegistry, currentIssuesAtom(yield* CurrentProjectId)).pipe(retry$1(forever$1), orDie, debounce(seconds(10)), runForEach((issues) => {
 		const issue = issues.find((entry) => entry.id === options.issueId);
-		if (!issue || issue.state === "in-progress" || issue.state === "in-review") return void_$1;
+		if (issue?.state === "in-progress" || issue?.state === "in-review") return void_$1;
 		return fail$6(new TaskStateChanged({
 			issueId: options.issueId,
-			state: issue.state
+			state: issue?.state ?? "missing"
 		}));
 	}), withSpan("Main.watchTaskState"));
 });
@@ -235650,7 +235709,7 @@ const commandEdit = make$49("edit").pipe(withDescription("Open the selected proj
 const commandSource = make$49("source").pipe(withDescription("Select the issue source to use (e.g. GitHub Issues or Linear). This applies to all projects."), withHandler(() => selectIssueSource), provide(Settings.layer));
 //#endregion
 //#region package.json
-var version = "0.3.61";
+var version = "0.3.62";
 //#endregion
 //#region src/commands/projects/ls.ts
 const commandProjectsLs = make$49("ls").pipe(withDescription("List configured projects and how they run (enabled state, concurrency, branch, git flow, review agent)."), withHandler(fnUntraced(function* () {
@@ -235670,6 +235729,7 @@ const commandProjectsLs = make$49("ls").pipe(withDescription("List configured pr
 		console.log(`  Concurrency: ${project.concurrency}`);
 		if (isSome(project.targetBranch)) console.log(`  Target Branch: ${project.targetBranch.value}`);
 		console.log(`  Git flow: ${project.gitFlow === "pr" ? "Pull Request" : "Commit"}`);
+		console.log(`  Research agent: ${project.researchAgent ? "Enabled" : "Disabled"}`);
 		console.log(`  Review agent: ${project.reviewAgent ? "Enabled" : "Disabled"}`);
 		console.log("");
 	}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lalph",
   "type": "module",
-  "version": "0.3.61",
+  "version": "0.3.62",
   "publishConfig": {
     "access": "public"
   },
@@ -29,12 +29,12 @@
     "@linear/sdk": "^77.0.0",
     "@octokit/plugin-rest-endpoint-methods": "^17.0.0",
     "@octokit/types": "^16.0.0",
-    "@typescript/native-preview": "7.0.0-dev.20260313.1",
-    "clanka": "^0.1.8",
+    "@typescript/native-preview": "7.0.0-dev.20260314.1",
+    "clanka": "^0.1.10",
     "concurrently": "^9.2.1",
     "effect": "4.0.0-beta.31",
     "husky": "^9.1.7",
-    "lint-staged": "^16.3.3",
+    "lint-staged": "^16.3.4",
     "octokit": "^5.0.5",
     "oxlint": "^1.55.0",
     "prettier": "^3.8.1",

package/src/Agents/researcher.ts

@@ -0,0 +1,31 @@
+import { Duration, Effect, Option } from "effect"
+import { PromptGen } from "../PromptGen.ts"
+import { Worktree } from "../Worktree.ts"
+import type { CliAgentPreset } from "../domain/CliAgentPreset.ts"
+import { runClanka } from "../Clanka.ts"
+import type { PrdIssue } from "../domain/PrdIssue.ts"
+
+export const agentResearcher = Effect.fnUntraced(function* (options: {
+  readonly task: PrdIssue
+  readonly specsDirectory: string
+  readonly stallTimeout: Duration.Duration
+  readonly preset: CliAgentPreset
+}) {
+  const worktree = yield* Worktree
+  const promptGen = yield* PromptGen
+
+  // use clanka
+  if (options.preset.cliAgent.command) {
+    return Option.none<string>()
+  }
+
+  return yield* runClanka({
+    directory: worktree.directory,
+    model: options.preset.extraArgs.join(" "),
+    system: promptGen.systemClanka(options),
+    prompt: promptGen.promptResearch({
+      task: options.task,
+    }),
+    stallTimeout: options.stallTimeout,
+  }).pipe(Effect.asSome)
+})

package/src/Agents/worker.ts

@@ -1,15 +1,17 @@
-import { Duration, Effect, Path, pipe, Stream } from "effect"
+import { Duration, Effect, Option, Path, pipe, Stream } from "effect"
 import { ChildProcess } from "effect/unstable/process"
 import { Worktree } from "../Worktree.ts"
 import type { CliAgentPreset } from "../domain/CliAgentPreset.ts"
 import { runClanka } from "../Clanka.ts"
 import { ExitCode } from "effect/unstable/process/ChildProcessSpawner"
+import { Prompt } from "effect/unstable/ai"
 
 export const agentWorker = Effect.fnUntraced(function* (options: {
   readonly stallTimeout: Duration.Duration
   readonly preset: CliAgentPreset
   readonly system?: string
   readonly prompt: string
+  readonly research: Option.Option<string>
   readonly steer?: Stream.Stream<string>
 }) {
   const pathService = yield* Path.Path
@@ -21,7 +23,22 @@ export const agentWorker = Effect.fnUntraced(function* (options: {
       directory: worktree.directory,
       model: options.preset.extraArgs.join(" "),
       system: options.system,
-      prompt: options.prompt,
+      prompt: Option.match(options.research, {
+        onNone: () => options.prompt,
+        onSome: (research) =>
+          Prompt.make([
+            {
+              role: "user",
+              content: options.prompt,
+            },
+            {
+              role: "assistant",
+              content: `Another software engineer has done some prior research for this task, and found the following information:
+
+${research}`,
+            },
+          ]),
+      }),
       stallTimeout: options.stallTimeout,
       steer: options.steer,
     })

package/src/Clanka.ts

@@ -4,6 +4,7 @@ import { TaskChooseTools, TaskTools, TaskToolsHandlers } from "./TaskTools.ts"
 import { ClankaModels } from "./ClankaModels.ts"
 import { withStallTimeout } from "./shared/stream.ts"
 import { NodeHttpClient } from "@effect/platform-node"
+import type { Prompt } from "effect/unstable/ai"
 
 export const ClankaMuxerLayer = Layer.effectDiscard(
   Effect.gen(function* () {
@@ -17,7 +18,7 @@ export const runClanka = Effect.fnUntraced(
   function* (options: {
     readonly directory: string
     readonly model: string
-    readonly prompt: string
+    readonly prompt: Prompt.RawInput
     readonly system?: string | undefined
     readonly stallTimeout?: Duration.Input | undefined
     readonly steer?: Stream.Stream<string> | undefined
@@ -54,9 +55,10 @@ export const runClanka = Effect.fnUntraced(
       )
     }
 
-    yield* stream.pipe(
+    return yield* stream.pipe(
       Stream.runDrain,
-      Effect.catchTag("AgentFinished", () => Effect.void),
+      Effect.as(""),
+      Effect.catchTag("AgentFinished", (e) => Effect.succeed(e.summary)),
     )
   },
   Effect.scoped,

package/src/Projects.ts

@@ -123,6 +123,11 @@ export const addOrUpdateProject = Effect.fnUntraced(function* (
       },
     ] as const,
   })
+
+  const researchAgent = yield* Prompt.toggle({
+    message: "Enable research agent?",
+    initial: existing ? existing.researchAgent : true,
+  })
   const reviewAgent = yield* Prompt.toggle({
     message: "Enable review agent?",
     initial: existing ? existing.reviewAgent : true,
@@ -134,6 +139,7 @@ export const addOrUpdateProject = Effect.fnUntraced(function* (
     concurrency,
     targetBranch,
     gitFlow,
+    researchAgent,
     reviewAgent,
   })
   yield* Settings.set(

package/src/PromptGen.ts

@@ -254,6 +254,24 @@ All steps must be done before the task can be considered complete.${
    - Rewrite the notes in the description to include only the key discoveries and information that could speed up future work on other tasks. Make sure to preserve important information such as specification file references.
    - If you believe the task is complete, update the \`state\` to "in-review".`
 
+      const promptResearch = (options: {
+        readonly task: PrdIssue
+      }) => `Your job is to gather all the necessary information and details to complete the task described below. Do not make any code changes yet, your job is just to research and gather information.
+
+In the final report:
+
+- Include key file names, line numbers, and code snippets that are relevant to the task.
+- Any key discoveries that will help with implementing the task.
+- Any other information that will help speed up the implementation of the task.
+- You DO NOT need to add your report to the task description, just include it in your final output.
+
+# Task details
+
+ID: ${options.task.id}
+Title: ${options.task.title}
+
+${options.task.description}`
+
       const promptReview = (options: {
         readonly prompt: string
         readonly gitFlow: GitFlow["Service"]
@@ -431,6 +449,7 @@ Make sure to setup dependencies between the tasks using the \`blockedBy\` field.
         promptChooseClanka,
         prompt,
         promptClanka,
+        promptResearch,
         promptReview,
         promptReviewCustom,
         promptTimeout,

package/src/commands/projects/ls.ts

@@ -35,6 +35,9 @@ export const commandProjectsLs = Command.make("ls").pipe(
         console.log(
           `  Git flow: ${project.gitFlow === "pr" ? "Pull Request" : "Commit"}`,
         )
+        console.log(
+          `  Research agent: ${project.researchAgent ? "Enabled" : "Disabled"}`,
+        )
         console.log(
           `  Review agent: ${project.reviewAgent ? "Enabled" : "Disabled"}`,
         )

package/src/commands/root.ts

@@ -55,6 +55,7 @@ import type { PrdIssue } from "../domain/PrdIssue.ts"
 import { CurrentTaskRef } from "../TaskTools.ts"
 import type { OutputFormatter } from "clanka"
 import { ClankaMuxerLayer } from "../Clanka.ts"
+import { agentResearcher } from "../Agents/researcher.ts"
 
 // Main iteration run logic
 
@@ -65,6 +66,7 @@ const run = Effect.fnUntraced(
     readonly specsDirectory: string
     readonly stallTimeout: Duration.Duration
     readonly runTimeout: Duration.Duration
+    readonly research: boolean
     readonly review: boolean
   }): Effect.fn.Return<
     void,
@@ -212,6 +214,16 @@ const run = Effect.fnUntraced(
         s.transitionTo(WorkerStatus.Working({ issueId: taskId })),
       )
 
+      let researchResult = Option.none<string>()
+      if (options.research) {
+        researchResult = yield* agentResearcher({
+          task: chosenTask.prd,
+          specsDirectory: options.specsDirectory,
+          stallTimeout: options.stallTimeout,
+          preset: taskPreset,
+        })
+      }
+
       const promptGen = yield* PromptGen
       const instructions = taskPreset.cliAgent.command
         ? promptGen.prompt({
@@ -243,6 +255,7 @@ const run = Effect.fnUntraced(
         stallTimeout: options.stallTimeout,
         preset: taskPreset,
         prompt: instructions,
+        research: researchResult,
         steer,
       }).pipe(
         Effect.provideService(CurrentTaskRef, issueRef),
@@ -352,6 +365,7 @@ const runProject = Effect.fnUntraced(
             stallTimeout: options.stallTimeout,
             runTimeout: options.runTimeout,
             review: options.project.reviewAgent,
+            research: options.project.researchAgent,
           }).pipe(
             Effect.provide(
               options.project.gitFlow === "commit" ? GitFlowCommit : GitFlowPR,
@@ -522,17 +536,13 @@ const watchTaskState = Effect.fnUntraced(function* (options: {
     Stream.debounce(Duration.seconds(10)),
     Stream.runForEach((issues) => {
       const issue = issues.find((entry) => entry.id === options.issueId)
-      if (
-        !issue ||
-        issue.state === "in-progress" ||
-        issue.state === "in-review"
-      ) {
+      if (issue?.state === "in-progress" || issue?.state === "in-review") {
         return Effect.void
       }
       return Effect.fail(
         new TaskStateChanged({
           issueId: options.issueId,
-          state: issue.state,
+          state: issue?.state ?? "missing",
         }),
       )
     }),

package/src/domain/Project.ts

@@ -9,5 +9,6 @@ export class Project extends Schema.Class<Project>("lalph/Project")({
   targetBranch: Schema.Option(Schema.String),
   concurrency: Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)),
   gitFlow: Schema.Literals(["pr", "commit"]),
+  researchAgent: Schema.Boolean.pipe(Schema.withDecodingDefault(() => false)),
   reviewAgent: Schema.Boolean,
 }) {}