@mastra/code-sdk 1.0.3-alpha.0 → 1.1.0-alpha.2

package/dist/utils/plan-diff.js

@@ -1,43 +1,62 @@
+//#region src/utils/plan-diff.ts
+/** Produce structured diff entries between two plan texts using an LCS diff. */
 function generatePlanDiff(oldText, newText) {
-  const oldLines = oldText.split(/\r?\n/);
-  const newLines = newText.split(/\r?\n/);
-  const n = oldLines.length;
-  const m = newLines.length;
-  const lcs = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
-  for (let i2 = n - 1; i2 >= 0; i2--) {
-    for (let j2 = m - 1; j2 >= 0; j2--) {
-      lcs[i2][j2] = oldLines[i2] === newLines[j2] ? lcs[i2 + 1][j2 + 1] + 1 : Math.max(lcs[i2 + 1][j2], lcs[i2][j2 + 1]);
-    }
-  }
-  const entries = [];
-  let i = 0;
-  let j = 0;
-  while (i < n && j < m) {
-    if (oldLines[i] === newLines[j]) {
-      entries.push({ type: "context", text: oldLines[i] });
-      i++;
-      j++;
-    } else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
-      entries.push({ type: "removed", text: oldLines[i] });
-      i++;
-    } else {
-      entries.push({ type: "added", text: newLines[j] });
-      j++;
-    }
-  }
-  while (i < n) entries.push({ type: "removed", text: oldLines[i++] });
-  while (j < m) entries.push({ type: "added", text: newLines[j++] });
-  return entries;
+	const oldLines = oldText.split(/\r?\n/);
+	const newLines = newText.split(/\r?\n/);
+	const n = oldLines.length;
+	const m = newLines.length;
+	const lcs = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+	for (let i = n - 1; i >= 0; i--) for (let j = m - 1; j >= 0; j--) lcs[i][j] = oldLines[i] === newLines[j] ? lcs[i + 1][j + 1] + 1 : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
+	const entries = [];
+	let i = 0;
+	let j = 0;
+	while (i < n && j < m) if (oldLines[i] === newLines[j]) {
+		entries.push({
+			type: "context",
+			text: oldLines[i]
+		});
+		i++;
+		j++;
+	} else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+		entries.push({
+			type: "removed",
+			text: oldLines[i]
+		});
+		i++;
+	} else {
+		entries.push({
+			type: "added",
+			text: newLines[j]
+		});
+		j++;
+	}
+	while (i < n) entries.push({
+		type: "removed",
+		text: oldLines[i++]
+	});
+	while (j < m) entries.push({
+		type: "added",
+		text: newLines[j++]
+	});
+	return entries;
 }
-function shouldShowDiff(previousPlan, plan, maxChangedRatio = 0.5) {
-  if (!previousPlan || previousPlan === plan) return false;
-  const entries = generatePlanDiff(previousPlan, plan);
-  const changed = entries.filter((e) => e.type !== "context").length;
-  if (changed === 0) return false;
-  return changed / Math.max(entries.length, 1) <= maxChangedRatio;
+/**
+* Decide whether a diff is worth rendering instead of just showing the full new plan.
+*
+* We generate the real diff and compare its size (added + removed lines) against the size
+* of the whole diff (added + removed + unchanged context). When most of the diff is changes
+* rather than shared context, the diff is no clearer than the full text, so callers fall
+* back to rendering the whole plan. A genuinely new plan (no previous text, or no shared
+* lines) is therefore shown in full.
+*/
+function shouldShowDiff(previousPlan, plan, maxChangedRatio = .5) {
+	if (!previousPlan || previousPlan === plan) return false;
+	const entries = generatePlanDiff(previousPlan, plan);
+	const changed = entries.filter((e) => e.type !== "context").length;
+	if (changed === 0) return false;
+	return changed / Math.max(entries.length, 1) <= maxChangedRatio;
 }
-export {
-  generatePlanDiff,
-  shouldShowDiff
-};
+//#endregion
+export { generatePlanDiff, shouldShowDiff };
+
 //# sourceMappingURL=plan-diff.js.map

package/dist/utils/plan-diff.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/plan-diff.ts"],"sourcesContent":["/**\n * Line-level diffing for plan revisions.\n *\n * Uses a real LCS (longest common subsequence) diff so that inserting or deleting a few\n * lines doesn't mark everything after it as changed. Both the rendered approval diff and\n * the \"is a diff worth showing\" heuristic share this so the heuristic measures the actual\n * diff rather than predicting one.\n */\n\nexport interface DiffEntry {\n  type: 'added' | 'removed' | 'context';\n  text: string;\n}\n\n/** Produce structured diff entries between two plan texts using an LCS diff. */\nexport function generatePlanDiff(oldText: string, newText: string): DiffEntry[] {\n  const oldLines = oldText.split(/\\r?\\n/);\n  const newLines = newText.split(/\\r?\\n/);\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  // LCS length table.\n  const lcs: number[][] = Array.from({ length: n + 1 }, () => new Array<number>(m + 1).fill(0));\n  for (let i = n - 1; i >= 0; i--) {\n    for (let j = m - 1; j >= 0; j--) {\n      lcs[i]![j] = oldLines[i] === newLines[j] ? lcs[i + 1]![j + 1]! + 1 : Math.max(lcs[i + 1]![j]!, lcs[i]![j + 1]!);\n    }\n  }\n\n  const entries: DiffEntry[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      entries.push({ type: 'context', text: oldLines[i]! });\n      i++;\n      j++;\n    } else if (lcs[i + 1]![j]! >= lcs[i]![j + 1]!) {\n      entries.push({ type: 'removed', text: oldLines[i]! });\n      i++;\n    } else {\n      entries.push({ type: 'added', text: newLines[j]! });\n      j++;\n    }\n  }\n  while (i < n) entries.push({ type: 'removed', text: oldLines[i++]! });\n  while (j < m) entries.push({ type: 'added', text: newLines[j++]! });\n\n  return entries;\n}\n\n/**\n * Decide whether a diff is worth rendering instead of just showing the full new plan.\n *\n * We generate the real diff and compare its size (added + removed lines) against the size\n * of the whole diff (added + removed + unchanged context). When most of the diff is changes\n * rather than shared context, the diff is no clearer than the full text, so callers fall\n * back to rendering the whole plan. A genuinely new plan (no previous text, or no shared\n * lines) is therefore shown in full.\n */\nexport function shouldShowDiff(previousPlan: string, plan: string, maxChangedRatio = 0.5): boolean {\n  if (!previousPlan || previousPlan === plan) return false;\n\n  const entries = generatePlanDiff(previousPlan, plan);\n  const changed = entries.filter(e => e.type !== 'context').length;\n  if (changed === 0) return false;\n\n  // changed / total entries == diff size relative to the full plan view.\n  return changed / Math.max(entries.length, 1) <= maxChangedRatio;\n}\n"],"mappings":"AAeO,SAAS,iBAAiB,SAAiB,SAA8B;AAC9E,QAAM,WAAW,QAAQ,MAAM,OAAO;AACtC,QAAM,WAAW,QAAQ,MAAM,OAAO;AACtC,QAAM,IAAI,SAAS;AACnB,QAAM,IAAI,SAAS;AAGnB,QAAM,MAAkB,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAAG,MAAM,IAAI,MAAc,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5F,WAASA,KAAI,IAAI,GAAGA,MAAK,GAAGA,MAAK;AAC/B,aAASC,KAAI,IAAI,GAAGA,MAAK,GAAGA,MAAK;AAC/B,UAAID,EAAC,EAAGC,EAAC,IAAI,SAASD,EAAC,MAAM,SAASC,EAAC,IAAI,IAAID,KAAI,CAAC,EAAGC,KAAI,CAAC,IAAK,IAAI,KAAK,IAAI,IAAID,KAAI,CAAC,EAAGC,EAAC,GAAI,IAAID,EAAC,EAAGC,KAAI,CAAC,CAAE;AAAA,IAChH;AAAA,EACF;AAEA,QAAM,UAAuB,CAAC;AAC9B,MAAI,IAAI;AACR,MAAI,IAAI;AACR,SAAO,IAAI,KAAK,IAAI,GAAG;AACrB,QAAI,SAAS,CAAC,MAAM,SAAS,CAAC,GAAG;AAC/B,cAAQ,KAAK,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC,EAAG,CAAC;AACpD;AACA;AAAA,IACF,WAAW,IAAI,IAAI,CAAC,EAAG,CAAC,KAAM,IAAI,CAAC,EAAG,IAAI,CAAC,GAAI;AAC7C,cAAQ,KAAK,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC,EAAG,CAAC;AACpD;AAAA,IACF,OAAO;AACL,cAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,SAAS,CAAC,EAAG,CAAC;AAClD;AAAA,IACF;AAAA,EACF;AACA,SAAO,IAAI,EAAG,SAAQ,KAAK,EAAE,MAAM,WAAW,MAAM,SAAS,GAAG,EAAG,CAAC;AACpE,SAAO,IAAI,EAAG,SAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,SAAS,GAAG,EAAG,CAAC;AAElE,SAAO;AACT;AAWO,SAAS,eAAe,cAAsB,MAAc,kBAAkB,KAAc;AACjG,MAAI,CAAC,gBAAgB,iBAAiB,KAAM,QAAO;AAEnD,QAAM,UAAU,iBAAiB,cAAc,IAAI;AACnD,QAAM,UAAU,QAAQ,OAAO,OAAK,EAAE,SAAS,SAAS,EAAE;AAC1D,MAAI,YAAY,EAAG,QAAO;AAG1B,SAAO,UAAU,KAAK,IAAI,QAAQ,QAAQ,CAAC,KAAK;AAClD;","names":["i","j"]}
+{"version":3,"file":"plan-diff.js","names":[],"sources":["../../src/utils/plan-diff.ts"],"sourcesContent":["/**\n * Line-level diffing for plan revisions.\n *\n * Uses a real LCS (longest common subsequence) diff so that inserting or deleting a few\n * lines doesn't mark everything after it as changed. Both the rendered approval diff and\n * the \"is a diff worth showing\" heuristic share this so the heuristic measures the actual\n * diff rather than predicting one.\n */\n\nexport interface DiffEntry {\n  type: 'added' | 'removed' | 'context';\n  text: string;\n}\n\n/** Produce structured diff entries between two plan texts using an LCS diff. */\nexport function generatePlanDiff(oldText: string, newText: string): DiffEntry[] {\n  const oldLines = oldText.split(/\\r?\\n/);\n  const newLines = newText.split(/\\r?\\n/);\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  // LCS length table.\n  const lcs: number[][] = Array.from({ length: n + 1 }, () => new Array<number>(m + 1).fill(0));\n  for (let i = n - 1; i >= 0; i--) {\n    for (let j = m - 1; j >= 0; j--) {\n      lcs[i]![j] = oldLines[i] === newLines[j] ? lcs[i + 1]![j + 1]! + 1 : Math.max(lcs[i + 1]![j]!, lcs[i]![j + 1]!);\n    }\n  }\n\n  const entries: DiffEntry[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      entries.push({ type: 'context', text: oldLines[i]! });\n      i++;\n      j++;\n    } else if (lcs[i + 1]![j]! >= lcs[i]![j + 1]!) {\n      entries.push({ type: 'removed', text: oldLines[i]! });\n      i++;\n    } else {\n      entries.push({ type: 'added', text: newLines[j]! });\n      j++;\n    }\n  }\n  while (i < n) entries.push({ type: 'removed', text: oldLines[i++]! });\n  while (j < m) entries.push({ type: 'added', text: newLines[j++]! });\n\n  return entries;\n}\n\n/**\n * Decide whether a diff is worth rendering instead of just showing the full new plan.\n *\n * We generate the real diff and compare its size (added + removed lines) against the size\n * of the whole diff (added + removed + unchanged context). When most of the diff is changes\n * rather than shared context, the diff is no clearer than the full text, so callers fall\n * back to rendering the whole plan. A genuinely new plan (no previous text, or no shared\n * lines) is therefore shown in full.\n */\nexport function shouldShowDiff(previousPlan: string, plan: string, maxChangedRatio = 0.5): boolean {\n  if (!previousPlan || previousPlan === plan) return false;\n\n  const entries = generatePlanDiff(previousPlan, plan);\n  const changed = entries.filter(e => e.type !== 'context').length;\n  if (changed === 0) return false;\n\n  // changed / total entries == diff size relative to the full plan view.\n  return changed / Math.max(entries.length, 1) <= maxChangedRatio;\n}\n"],"mappings":";;AAeA,SAAgB,iBAAiB,SAAiB,SAA8B;CAC9E,MAAM,WAAW,QAAQ,MAAM,OAAO;CACtC,MAAM,WAAW,QAAQ,MAAM,OAAO;CACtC,MAAM,IAAI,SAAS;CACnB,MAAM,IAAI,SAAS;CAGnB,MAAM,MAAkB,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,IAAI,MAAc,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;CAC5F,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,KAC1B,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,KAC1B,IAAI,EAAE,CAAE,KAAK,SAAS,OAAO,SAAS,KAAK,IAAI,IAAI,EAAE,CAAE,IAAI,KAAM,IAAI,KAAK,IAAI,IAAI,IAAI,EAAE,CAAE,IAAK,IAAI,EAAE,CAAE,IAAI,EAAG;CAIlH,MAAM,UAAuB,CAAC;CAC9B,IAAI,IAAI;CACR,IAAI,IAAI;CACR,OAAO,IAAI,KAAK,IAAI,GAClB,IAAI,SAAS,OAAO,SAAS,IAAI;EAC/B,QAAQ,KAAK;GAAE,MAAM;GAAW,MAAM,SAAS;EAAI,CAAC;EACpD;EACA;CACF,OAAO,IAAI,IAAI,IAAI,EAAE,CAAE,MAAO,IAAI,EAAE,CAAE,IAAI,IAAK;EAC7C,QAAQ,KAAK;GAAE,MAAM;GAAW,MAAM,SAAS;EAAI,CAAC;EACpD;CACF,OAAO;EACL,QAAQ,KAAK;GAAE,MAAM;GAAS,MAAM,SAAS;EAAI,CAAC;EAClD;CACF;CAEF,OAAO,IAAI,GAAG,QAAQ,KAAK;EAAE,MAAM;EAAW,MAAM,SAAS;CAAM,CAAC;CACpE,OAAO,IAAI,GAAG,QAAQ,KAAK;EAAE,MAAM;EAAS,MAAM,SAAS;CAAM,CAAC;CAElE,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,eAAe,cAAsB,MAAc,kBAAkB,IAAc;CACjG,IAAI,CAAC,gBAAgB,iBAAiB,MAAM,OAAO;CAEnD,MAAM,UAAU,iBAAiB,cAAc,IAAI;CACnD,MAAM,UAAU,QAAQ,QAAO,MAAK,EAAE,SAAS,SAAS,CAAC,CAAC;CAC1D,IAAI,YAAY,GAAG,OAAO;CAG1B,OAAO,UAAU,KAAK,IAAI,QAAQ,QAAQ,CAAC,KAAK;AAClD"}

package/dist/utils/plans.js

@@ -1,99 +1,117 @@
-import fs from "node:fs/promises";
-import path from "node:path";
 import { DEFAULT_CONFIG_DIR } from "../constants.js";
 import { getAppDataDir } from "./project.js";
+import path from "path";
+import fs from "fs/promises";
+//#region src/utils/plans.ts
+/** Global plans directory for approved-plan archives. */
 function getPlansDir() {
-  return process.env.MASTRA_PLANS_DIR ?? path.join(getAppDataDir(), "plans");
+	return process.env.MASTRA_PLANS_DIR ?? path.join(getAppDataDir(), "plans");
 }
+/** Local (project-scoped) plans directory where the agent writes named plan files. */
 function getLocalPlansDir(projectPath) {
-  return path.join(projectPath, DEFAULT_CONFIG_DIR, "plans");
+	return path.join(projectPath, DEFAULT_CONFIG_DIR, "plans");
 }
+/** Workspace-relative directory the agent writes plan files into. */
 function getLocalPlansRelativeDir() {
-  return path.join(DEFAULT_CONFIG_DIR, "plans");
+	return path.join(DEFAULT_CONFIG_DIR, "plans");
 }
 function slugify(str) {
-  const slug = str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-  return slug || "untitled";
+	return str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "untitled";
 }
+/** Derive a plan filename from a title (e.g. `add-dark-mode.md`). */
 function getPlanFilename(title) {
-  return `${slugify(title)}.md`;
+	return `${slugify(title)}.md`;
 }
+/**
+* Suggested workspace-relative path for a new plan file, shown in plan-mode prompts.
+* Without a title we fall back to a generic name the agent can rename later.
+*/
 function getSuggestedPlanRelativePath(title) {
-  const filename = title ? getPlanFilename(title) : "plan.md";
-  return path.join(getLocalPlansRelativeDir(), filename);
+	const filename = title ? getPlanFilename(title) : "plan.md";
+	return path.join(getLocalPlansRelativeDir(), filename);
 }
+/**
+* Resolve a plan path submitted by the agent (absolute or project-relative) to an
+* absolute path. Returns `undefined` when no usable path was provided.
+*/
 function resolvePlanPath(projectPath, submittedPath) {
-  if (!submittedPath) return void 0;
-  return path.isAbsolute(submittedPath) ? submittedPath : path.resolve(projectPath, submittedPath);
+	if (!submittedPath) return void 0;
+	return path.isAbsolute(submittedPath) ? submittedPath : path.resolve(projectPath, submittedPath);
 }
+/**
+* Whether `targetPath` (absolute or project-relative) is a valid plan file: a `.md`
+* file located directly inside the project's `.mastracode/plans/` directory. Used by the
+* plan-mode write guard so the agent can write any named plan file there, but nothing
+* outside that directory.
+*/
 function isPlanFilePath(projectPath, targetPath) {
-  const abs = resolvePlanPath(projectPath, targetPath);
-  if (!abs) return false;
-  if (path.extname(abs).toLowerCase() !== ".md") return false;
-  const plansDir = path.resolve(getLocalPlansDir(projectPath));
-  const rel = path.relative(plansDir, abs);
-  if (rel === "" || rel.startsWith("..") || path.isAbsolute(rel)) return false;
-  return !rel.includes(path.sep);
+	const abs = resolvePlanPath(projectPath, targetPath);
+	if (!abs) return false;
+	if (path.extname(abs).toLowerCase() !== ".md") return false;
+	const plansDir = path.resolve(getLocalPlansDir(projectPath));
+	const rel = path.relative(plansDir, abs);
+	if (rel === "" || rel.startsWith("..") || path.isAbsolute(rel)) return false;
+	return !rel.includes(path.sep);
 }
 async function savePlanToDisk(opts) {
-  const { title, plan, resourceId } = opts;
-  const plansDir = opts.plansDir ?? getPlansDir();
-  const baseDir = path.resolve(plansDir);
-  const dir = path.resolve(baseDir, resourceId);
-  const rel = path.relative(baseDir, dir);
-  if (rel.startsWith("..") || path.isAbsolute(rel)) {
-    throw new Error(`Invalid resourceId: ${resourceId}`);
-  }
-  await fs.mkdir(dir, { recursive: true });
-  const now = /* @__PURE__ */ new Date();
-  const timestamp = now.toISOString().replace(/:/g, "-");
-  const slug = slugify(title);
-  const filename = `${timestamp}-${slug}.md`;
-  const content = `# ${title}
-
-Approved: ${now.toISOString()}
-
-${plan}
-`;
-  await fs.writeFile(path.join(dir, filename), content, "utf-8");
+	const { title, plan, resourceId } = opts;
+	const plansDir = opts.plansDir ?? getPlansDir();
+	const baseDir = path.resolve(plansDir);
+	const dir = path.resolve(baseDir, resourceId);
+	const rel = path.relative(baseDir, dir);
+	if (rel.startsWith("..") || path.isAbsolute(rel)) throw new Error(`Invalid resourceId: ${resourceId}`);
+	await fs.mkdir(dir, { recursive: true });
+	const now = /* @__PURE__ */ new Date();
+	const filename = `${now.toISOString().replace(/:/g, "-")}-${slugify(title)}.md`;
+	const content = `# ${title}\n\nApproved: ${now.toISOString()}\n\n${plan}\n`;
+	await fs.writeFile(path.join(dir, filename), content, "utf-8");
 }
+/**
+* Read a plan markdown file by absolute path.
+*
+* The leading `# <title>` heading (if present) is parsed as the title and the remaining
+* content is returned as the plan body. Returns `undefined` when the file does not exist.
+*/
 async function readPlanFile(absPath) {
-  let raw;
-  try {
-    raw = await fs.readFile(absPath, "utf-8");
-  } catch {
-    return void 0;
-  }
-  const lines = raw.split(/\r?\n/);
-  const headingIndex = lines.findIndex((line) => line.trim().length > 0);
-  const heading = headingIndex >= 0 ? lines[headingIndex] : void 0;
-  if (heading?.startsWith("# ")) {
-    const title = heading.slice(2).trim();
-    const plan = lines.slice(headingIndex + 1).join("\n").replace(/^\n+/, "").trimEnd();
-    return { title, plan };
-  }
-  return { title: "", plan: raw.trimEnd() };
+	let raw;
+	try {
+		raw = await fs.readFile(absPath, "utf-8");
+	} catch {
+		return;
+	}
+	const lines = raw.split(/\r?\n/);
+	const headingIndex = lines.findIndex((line) => line.trim().length > 0);
+	const heading = headingIndex >= 0 ? lines[headingIndex] : void 0;
+	if (heading?.startsWith("# ")) return {
+		title: heading.slice(2).trim(),
+		plan: lines.slice(headingIndex + 1).join("\n").replace(/^\n+/, "").trimEnd()
+	};
+	return {
+		title: "",
+		plan: raw.trimEnd()
+	};
 }
+/**
+* Approve the plan file at `planPath`: write a timestamped copy to the global plans
+* archive so approved plans are findable later. The local named plan file is left in
+* place so the user can review every plan made over time.
+*
+* Returns the local plan filename (e.g. `add-dark-mode.md`), or `undefined` when there
+* was no plan file to approve.
+*/
 async function approvePlanFile(opts) {
-  const { planPath, title, resourceId, plansDir } = opts;
-  const current = await readPlanFile(planPath);
-  if (!current) {
-    return void 0;
-  }
-  const resolvedTitle = title || current.title || "Implementation Plan";
-  await savePlanToDisk({ title: resolvedTitle, plan: current.plan, resourceId, plansDir });
-  return path.basename(planPath);
+	const { planPath, title, resourceId, plansDir } = opts;
+	const current = await readPlanFile(planPath);
+	if (!current) return;
+	await savePlanToDisk({
+		title: title || current.title || "Implementation Plan",
+		plan: current.plan,
+		resourceId,
+		plansDir
+	});
+	return path.basename(planPath);
 }
-export {
-  approvePlanFile,
-  getLocalPlansDir,
-  getLocalPlansRelativeDir,
-  getPlanFilename,
-  getPlansDir,
-  getSuggestedPlanRelativePath,
-  isPlanFilePath,
-  readPlanFile,
-  resolvePlanPath,
-  savePlanToDisk
-};
+//#endregion
+export { approvePlanFile, getLocalPlansDir, getLocalPlansRelativeDir, getPlanFilename, getPlansDir, getSuggestedPlanRelativePath, isPlanFilePath, readPlanFile, resolvePlanPath, savePlanToDisk };
+
 //# sourceMappingURL=plans.js.map

package/dist/utils/plans.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/plans.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { getAppDataDir } from './project.js';\n\n/** Global plans directory for approved-plan archives. */\nexport function getPlansDir(): string {\n  return process.env.MASTRA_PLANS_DIR ?? path.join(getAppDataDir(), 'plans');\n}\n\n/** Local (project-scoped) plans directory where the agent writes named plan files. */\nexport function getLocalPlansDir(projectPath: string): string {\n  return path.join(projectPath, DEFAULT_CONFIG_DIR, 'plans');\n}\n\n/** Workspace-relative directory the agent writes plan files into. */\nexport function getLocalPlansRelativeDir(): string {\n  return path.join(DEFAULT_CONFIG_DIR, 'plans');\n}\n\nfunction slugify(str: string): string {\n  const slug = str\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n  return slug || 'untitled';\n}\n\n/** Derive a plan filename from a title (e.g. `add-dark-mode.md`). */\nexport function getPlanFilename(title: string): string {\n  return `${slugify(title)}.md`;\n}\n\n/**\n * Suggested workspace-relative path for a new plan file, shown in plan-mode prompts.\n * Without a title we fall back to a generic name the agent can rename later.\n */\nexport function getSuggestedPlanRelativePath(title?: string): string {\n  const filename = title ? getPlanFilename(title) : 'plan.md';\n  return path.join(getLocalPlansRelativeDir(), filename);\n}\n\n/**\n * Resolve a plan path submitted by the agent (absolute or project-relative) to an\n * absolute path. Returns `undefined` when no usable path was provided.\n */\nexport function resolvePlanPath(projectPath: string, submittedPath: string): string | undefined {\n  if (!submittedPath) return undefined;\n  return path.isAbsolute(submittedPath) ? submittedPath : path.resolve(projectPath, submittedPath);\n}\n\n/**\n * Whether `targetPath` (absolute or project-relative) is a valid plan file: a `.md`\n * file located directly inside the project's `.mastracode/plans/` directory. Used by the\n * plan-mode write guard so the agent can write any named plan file there, but nothing\n * outside that directory.\n */\nexport function isPlanFilePath(projectPath: string, targetPath: string): boolean {\n  const abs = resolvePlanPath(projectPath, targetPath);\n  if (!abs) return false;\n  if (path.extname(abs).toLowerCase() !== '.md') return false;\n\n  const plansDir = path.resolve(getLocalPlansDir(projectPath));\n  const rel = path.relative(plansDir, abs);\n  // Must be directly inside the plans dir (no nested subdirectories, no escaping it).\n  if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) return false;\n  return !rel.includes(path.sep);\n}\n\nexport async function savePlanToDisk(opts: {\n  title: string;\n  plan: string;\n  resourceId: string;\n  plansDir?: string;\n}): Promise<void> {\n  const { title, plan, resourceId } = opts;\n  const plansDir = opts.plansDir ?? getPlansDir();\n  const baseDir = path.resolve(plansDir);\n  const dir = path.resolve(baseDir, resourceId);\n  const rel = path.relative(baseDir, dir);\n  if (rel.startsWith('..') || path.isAbsolute(rel)) {\n    throw new Error(`Invalid resourceId: ${resourceId}`);\n  }\n\n  await fs.mkdir(dir, { recursive: true });\n\n  const now = new Date();\n  const timestamp = now.toISOString().replace(/:/g, '-');\n  const slug = slugify(title);\n  const filename = `${timestamp}-${slug}.md`;\n\n  const content = `# ${title}\\n\\nApproved: ${now.toISOString()}\\n\\n${plan}\\n`;\n\n  await fs.writeFile(path.join(dir, filename), content, 'utf-8');\n}\n\n/**\n * Read a plan markdown file by absolute path.\n *\n * The leading `# <title>` heading (if present) is parsed as the title and the remaining\n * content is returned as the plan body. Returns `undefined` when the file does not exist.\n */\nexport async function readPlanFile(absPath: string): Promise<{ title: string; plan: string } | undefined> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(absPath, 'utf-8');\n  } catch {\n    return undefined;\n  }\n\n  const lines = raw.split(/\\r?\\n/);\n  const headingIndex = lines.findIndex(line => line.trim().length > 0);\n  const heading = headingIndex >= 0 ? lines[headingIndex] : undefined;\n  if (heading?.startsWith('# ')) {\n    const title = heading.slice(2).trim();\n    const plan = lines\n      .slice(headingIndex + 1)\n      .join('\\n')\n      .replace(/^\\n+/, '')\n      .trimEnd();\n    return { title, plan };\n  }\n\n  return { title: '', plan: raw.trimEnd() };\n}\n\n/**\n * Approve the plan file at `planPath`: write a timestamped copy to the global plans\n * archive so approved plans are findable later. The local named plan file is left in\n * place so the user can review every plan made over time.\n *\n * Returns the local plan filename (e.g. `add-dark-mode.md`), or `undefined` when there\n * was no plan file to approve.\n */\nexport async function approvePlanFile(opts: {\n  planPath: string;\n  title: string;\n  resourceId: string;\n  plansDir?: string;\n}): Promise<string | undefined> {\n  const { planPath, title, resourceId, plansDir } = opts;\n\n  const current = await readPlanFile(planPath);\n  if (!current) {\n    return undefined;\n  }\n\n  const resolvedTitle = title || current.title || 'Implementation Plan';\n\n  // Global archive (timestamped, never overwritten) so approved plans are findable later.\n  await savePlanToDisk({ title: resolvedTitle, plan: current.plan, resourceId, plansDir });\n\n  return path.basename(planPath);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"plans.js","names":[],"sources":["../../src/utils/plans.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { getAppDataDir } from './project.js';\n\n/** Global plans directory for approved-plan archives. */\nexport function getPlansDir(): string {\n  return process.env.MASTRA_PLANS_DIR ?? path.join(getAppDataDir(), 'plans');\n}\n\n/** Local (project-scoped) plans directory where the agent writes named plan files. */\nexport function getLocalPlansDir(projectPath: string): string {\n  return path.join(projectPath, DEFAULT_CONFIG_DIR, 'plans');\n}\n\n/** Workspace-relative directory the agent writes plan files into. */\nexport function getLocalPlansRelativeDir(): string {\n  return path.join(DEFAULT_CONFIG_DIR, 'plans');\n}\n\nfunction slugify(str: string): string {\n  const slug = str\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n  return slug || 'untitled';\n}\n\n/** Derive a plan filename from a title (e.g. `add-dark-mode.md`). */\nexport function getPlanFilename(title: string): string {\n  return `${slugify(title)}.md`;\n}\n\n/**\n * Suggested workspace-relative path for a new plan file, shown in plan-mode prompts.\n * Without a title we fall back to a generic name the agent can rename later.\n */\nexport function getSuggestedPlanRelativePath(title?: string): string {\n  const filename = title ? getPlanFilename(title) : 'plan.md';\n  return path.join(getLocalPlansRelativeDir(), filename);\n}\n\n/**\n * Resolve a plan path submitted by the agent (absolute or project-relative) to an\n * absolute path. Returns `undefined` when no usable path was provided.\n */\nexport function resolvePlanPath(projectPath: string, submittedPath: string): string | undefined {\n  if (!submittedPath) return undefined;\n  return path.isAbsolute(submittedPath) ? submittedPath : path.resolve(projectPath, submittedPath);\n}\n\n/**\n * Whether `targetPath` (absolute or project-relative) is a valid plan file: a `.md`\n * file located directly inside the project's `.mastracode/plans/` directory. Used by the\n * plan-mode write guard so the agent can write any named plan file there, but nothing\n * outside that directory.\n */\nexport function isPlanFilePath(projectPath: string, targetPath: string): boolean {\n  const abs = resolvePlanPath(projectPath, targetPath);\n  if (!abs) return false;\n  if (path.extname(abs).toLowerCase() !== '.md') return false;\n\n  const plansDir = path.resolve(getLocalPlansDir(projectPath));\n  const rel = path.relative(plansDir, abs);\n  // Must be directly inside the plans dir (no nested subdirectories, no escaping it).\n  if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) return false;\n  return !rel.includes(path.sep);\n}\n\nexport async function savePlanToDisk(opts: {\n  title: string;\n  plan: string;\n  resourceId: string;\n  plansDir?: string;\n}): Promise<void> {\n  const { title, plan, resourceId } = opts;\n  const plansDir = opts.plansDir ?? getPlansDir();\n  const baseDir = path.resolve(plansDir);\n  const dir = path.resolve(baseDir, resourceId);\n  const rel = path.relative(baseDir, dir);\n  if (rel.startsWith('..') || path.isAbsolute(rel)) {\n    throw new Error(`Invalid resourceId: ${resourceId}`);\n  }\n\n  await fs.mkdir(dir, { recursive: true });\n\n  const now = new Date();\n  const timestamp = now.toISOString().replace(/:/g, '-');\n  const slug = slugify(title);\n  const filename = `${timestamp}-${slug}.md`;\n\n  const content = `# ${title}\\n\\nApproved: ${now.toISOString()}\\n\\n${plan}\\n`;\n\n  await fs.writeFile(path.join(dir, filename), content, 'utf-8');\n}\n\n/**\n * Read a plan markdown file by absolute path.\n *\n * The leading `# <title>` heading (if present) is parsed as the title and the remaining\n * content is returned as the plan body. Returns `undefined` when the file does not exist.\n */\nexport async function readPlanFile(absPath: string): Promise<{ title: string; plan: string } | undefined> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(absPath, 'utf-8');\n  } catch {\n    return undefined;\n  }\n\n  const lines = raw.split(/\\r?\\n/);\n  const headingIndex = lines.findIndex(line => line.trim().length > 0);\n  const heading = headingIndex >= 0 ? lines[headingIndex] : undefined;\n  if (heading?.startsWith('# ')) {\n    const title = heading.slice(2).trim();\n    const plan = lines\n      .slice(headingIndex + 1)\n      .join('\\n')\n      .replace(/^\\n+/, '')\n      .trimEnd();\n    return { title, plan };\n  }\n\n  return { title: '', plan: raw.trimEnd() };\n}\n\n/**\n * Approve the plan file at `planPath`: write a timestamped copy to the global plans\n * archive so approved plans are findable later. The local named plan file is left in\n * place so the user can review every plan made over time.\n *\n * Returns the local plan filename (e.g. `add-dark-mode.md`), or `undefined` when there\n * was no plan file to approve.\n */\nexport async function approvePlanFile(opts: {\n  planPath: string;\n  title: string;\n  resourceId: string;\n  plansDir?: string;\n}): Promise<string | undefined> {\n  const { planPath, title, resourceId, plansDir } = opts;\n\n  const current = await readPlanFile(planPath);\n  if (!current) {\n    return undefined;\n  }\n\n  const resolvedTitle = title || current.title || 'Implementation Plan';\n\n  // Global archive (timestamped, never overwritten) so approved plans are findable later.\n  await savePlanToDisk({ title: resolvedTitle, plan: current.plan, resourceId, plansDir });\n\n  return path.basename(planPath);\n}\n"],"mappings":"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"}