feat: Allow localization of the "Next actions" and "Milestones" headers

package.json

@@ -34,6 +34,7 @@
     "@types/jsdom": "^27.0.0",
     "@types/marked-terminal": "^6.1.1",
     "@types/node": "^20.11.19",
+    "@types/regex-escape": "^3.4.1",
     "@typescript-eslint/eslint-plugin": "^6.21.0",
     "@typescript-eslint/parser": "^6.21.0",
     "builtin-modules": "^3.3.0",
@@ -59,6 +60,7 @@
     "gray-matter": "^4.0.3",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
+    "regex-escape": "^3.4.11",
     "uuid": "^13.0.0"
   }
 }

src/file-writer.ts

@@ -1,9 +1,10 @@
 import type { App } from "obsidian";
 import { TFile, normalizePath } from "obsidian";
-import { FlowProject, GTDProcessingResult, PluginSettings, PersonNote } from "./types";
+import { FlowProject, GTDProcessingResult, PluginSettings, PersonNote, nextActionsHeaderText } from "./types";
 import { GTDResponseValidationError, FileNotFoundError, ValidationError } from "./errors";
 import { EditableItem } from "./inbox-types";
 import { sanitizeFileName } from "./validation";
+import escapeRegex from "regex-escape";
 
 export class FileWriter {
   constructor(
@@ -244,7 +245,7 @@ export class FileWriter {
       const isDone = markAsDone[i] || false;
       content = this.addActionToSection(
         content,
-        "## Next actions",
+        `## ${nextActionsHeaderText(this.settings)}`,
         action,
         isWaiting,
         isDone,
@@ -413,62 +414,64 @@ export class FileWriter {
     }
 
     // Add next actions to the template
-    let content = templateContent;
+    let actionsText = "";
+    const dueDateSuffix = dueDate ? ` 📅 ${dueDate}` : "";
 
-    // Find the "## Next actions" section and add the actions
-    const nextActionsRegex = /(## Next actions\s*\n)(\s*)/;
-    const match = content.match(nextActionsRegex);
+    if (result.nextActions && result.nextActions.length > 0) {
+      actionsText =
+        result.nextActions
+          .map((action, i) => {
+            const isDone = markAsDone[i] || false;
+            const isWaiting = waitingFor[i] || false;
 
-    if (match) {
-      let actionsText = "";
-      const dueDateSuffix = dueDate ? ` 📅 ${dueDate}` : "";
-
-      if (result.nextActions && result.nextActions.length > 0) {
-        actionsText =
-          result.nextActions
-            .map((action, i) => {
-              const isDone = markAsDone[i] || false;
-              const isWaiting = waitingFor[i] || false;
-
-              let checkbox: string;
-              let actionText = action;
-
-              if (isDone) {
-                checkbox = "- [x]";
-                const completionDate = new Date().toISOString().split("T")[0];
-                actionText = `${action} ✅ ${completionDate}`;
-              } else if (isWaiting) {
-                checkbox = "- [w]";
-              } else {
-                checkbox = "- [ ]";
-              }
-
-              return `${checkbox} ${actionText}${dueDateSuffix}`;
-            })
-            .join("\n") + "\n";
-      } else if (result.nextAction) {
-        const isDone = markAsDone[0] || false;
-        const isWaiting = waitingFor[0] || false;
-
-        let checkbox: string;
-        let actionText = result.nextAction;
-
-        if (isDone) {
-          checkbox = "- [x]";
-          const completionDate = new Date().toISOString().split("T")[0];
-          actionText = `${result.nextAction} ✅ ${completionDate}`;
-        } else if (isWaiting) {
-          checkbox = "- [w]";
-        } else {
-          checkbox = "- [ ]";
-        }
+            let checkbox: string;
+            let actionText = action;
+
+            if (isDone) {
+              checkbox = "- [x]";
+              const completionDate = new Date().toISOString().split("T")[0];
+              actionText = `${action} ✅ ${completionDate}`;
+            } else if (isWaiting) {
+              checkbox = "- [w]";
+            } else {
+              checkbox = "- [ ]";
+            }
+
+            return `${checkbox} ${actionText}${dueDateSuffix}`;
+          })
+          .join("\n") + "\n";
+    } else if (result.nextAction) {
+      const isDone = markAsDone[0] || false;
+      const isWaiting = waitingFor[0] || false;
+
+      let checkbox: string;
+      let actionText = result.nextAction;
 
-        actionsText = `${checkbox} ${actionText}${dueDateSuffix}\n`;
+      if (isDone) {
+        checkbox = "- [x]";
+        const completionDate = new Date().toISOString().split("T")[0];
+        actionText = `${result.nextAction} ✅ ${completionDate}`;
+      } else if (isWaiting) {
+        checkbox = "- [w]";
+      } else {
+        checkbox = "- [ ]";
       }
 
+      actionsText = `${checkbox} ${actionText}${dueDateSuffix}\n`;
+    }
+
+    // Find the "## Next actions" section and add the actions
+    let content = templateContent;
+    const nextActionsRegex = new RegExp(`(##\\s*${escapeRegex(nextActionsHeaderText(this.settings))}\\s*(?:\\n|$))(\\s*)`);
+    const match = content.match(nextActionsRegex);
+
+    if (match) {
       // Replace "## Next actions\n<any whitespace>" with "## Next actions\n<actions>\n"
       // This ensures proper spacing regardless of template whitespace
       content = content.replace(nextActionsRegex, `$1${actionsText}\n`);
+    } else {
+      // Fallback: Append at the end if the section is not found
+      content += `\n## ${nextActionsHeaderText(this.settings)}\n${actionsText}\n`;
     }
 
     return content;
@@ -490,6 +493,7 @@ export class FileWriter {
     const date = this.formatDate(new Date());
     const title = result.projectOutcome || originalItem;
     const originalItemDescription = this.formatOriginalInboxItem(originalItem, sourceNoteLink);
+    const nextActionsHeader = nextActionsHeaderText(this.settings);
 
     // Format sphere tags for YAML list format
     const sphereTagsList =
@@ -524,7 +528,7 @@ status: ${this.settings.defaultStatus}`;
 
 ${originalItemDescription}
 
-## Next actions
+## ${nextActionsHeader}
 `;
 
     // Handle multiple next actions or single next action

src/flow-scanner.ts

@@ -1,11 +1,14 @@
 import type { App, TFile, CachedMetadata } from "obsidian";
-import { FlowProject } from "./types";
+import { FlowProject, milestonesHeaderText, nextActionsHeaderText, PluginSettings } from "./types";
 import { ProjectNode, buildProjectHierarchy } from "./project-hierarchy";
 
 export class FlowProjectScanner {
   private cache: Map<string, { mtime: number; project: FlowProject }> = new Map();
 
-  constructor(private app: App) {}
+  constructor(
+    private app: App,
+    private settings: PluginSettings
+  ) {}
 
   /**
    * Scans the vault for all Flow projects (files with tags starting with 'project/')
@@ -60,9 +63,9 @@ export class FlowProjectScanner {
       status: frontmatter.status,
       creationDate: frontmatter["creation-date"],
       mtime: file.stat.mtime,
-      nextActions: this.extractSection(content, "## Next actions"),
+      nextActions: this.extractSection(content, `## ${nextActionsHeaderText(this.settings)}`),
       parentProject: frontmatter["parent-project"],
-      milestones: this.extractSectionText(content, "## Milestones"),
+      milestones: this.extractSectionText(content, `## ${milestonesHeaderText(this.settings)}`),
       coverImage: frontmatter["cover-image"],
       current: frontmatter.current === true,
     };

src/focus-view.ts

@@ -33,7 +33,7 @@ export class FocusView extends RefreshingView {
     super(leaf);
     this.settings = settings;
     this.validator = new FocusValidator(this.app);
-    this.scanner = new FlowProjectScanner(this.app);
+    this.scanner = new FlowProjectScanner(this.app, settings);
     this.saveSettings = saveSettings;
 
     // Check if Dataview is available for fast refreshes

src/inbox-processing-controller.ts

@@ -34,7 +34,7 @@ export class InboxProcessingController {
     saveSettings?: () => Promise<void>
   ) {
     this.settings = settings;
-    this.scanner = dependencies.scanner ?? new FlowProjectScanner(app);
+    this.scanner = dependencies.scanner ?? new FlowProjectScanner(app, settings);
     this.personScanner = dependencies.personScanner ?? new PersonScanner(app);
     this.writer = dependencies.writer ?? new FileWriter(app, settings);
     this.inboxScanner = (

src/new-project-modal.ts

@@ -32,7 +32,7 @@ export class NewProjectModal extends Modal {
     super(app);
     this.settings = settings;
     this.saveSettings = saveSettings;
-    this.scanner = new FlowProjectScanner(app);
+    this.scanner = new FlowProjectScanner(app, settings);
     this.fileWriter = new FileWriter(app, settings);
     this.data = {
       title: "",

src/settings-tab.ts

@@ -363,6 +363,38 @@ export class FlowGTDSettingTab extends PluginSettingTab {
           })
       );
 
+    // Next Actions Header Text
+    new Setting(containerEl)
+      .setName("Next Actions Header Text")
+      .setDesc(
+        "Alternative text for the \"Next actions\" header in project files."
+      )
+      .addText((text) =>
+        text
+          .setPlaceholder("Next actions")
+          .setValue(this.plugin.settings.nextActionsHeaderText)
+          .onChange(async (value) => {
+            this.plugin.settings.nextActionsHeaderText = value;
+            await this.plugin.saveSettings();
+          })
+      );
+
+    // Milestones Header Text
+    new Setting(containerEl)
+      .setName("Milestones Header Text")
+      .setDesc(
+        "Alternative text for the \"Milestones\" header in project files."
+      )
+      .addText((text) =>
+        text
+          .setPlaceholder("Milestones")
+          .setValue(this.plugin.settings.milestonesHeaderText)
+          .onChange(async (value) => {
+            this.plugin.settings.milestonesHeaderText = value;
+            await this.plugin.saveSettings();
+          })
+      );
+
     // Default Inbox File
     new Setting(containerEl)
       .setName("Default Inbox File")

src/someday-scanner.ts

@@ -32,7 +32,7 @@ export class SomedayScanner {
   constructor(app: App, settings: PluginSettings) {
     this.app = app;
     this.settings = settings;
-    this.projectScanner = new FlowProjectScanner(app);
+    this.projectScanner = new FlowProjectScanner(app, settings);
   }
 
   private extractSphere(lineContent: string): string | undefined {

src/sphere-data-loader.ts

@@ -35,7 +35,7 @@ export class SphereDataLoader {
     this.app = app;
     this.sphere = sphere;
     this.settings = settings;
-    this.scanner = new FlowProjectScanner(app);
+    this.scanner = new FlowProjectScanner(app, settings);
   }
 
   async loadSphereData(): Promise<SphereViewData> {

src/types/settings.ts

@@ -17,6 +17,8 @@ export interface PluginSettings {
   inboxFilesFolderPath: string;
   inboxFolderPath: string;
   processedInboxFolderPath: string;
+  nextActionsHeaderText: string; // Header text to use instead of "Next actions"
+  milestonesHeaderText: string; // Header text to use instead of "Milestones"
   nextActionsFilePath: string;
   somedayFilePath: string;
   projectsFolderPath: string;
@@ -51,6 +53,8 @@ export const DEFAULT_SETTINGS: PluginSettings = {
   inboxFolderPath: "Flow Inbox Folder",
   processedInboxFolderPath: "Processed Inbox Folder Notes",
   nextActionsFilePath: "Next actions.md",
+  nextActionsHeaderText: "Next actions",
+  milestonesHeaderText: "Milestones",
   somedayFilePath: "Someday.md",
   projectsFolderPath: "Projects",
   projectTemplateFilePath: "Templates/Project.md",
@@ -68,3 +72,27 @@ export const DEFAULT_SETTINGS: PluginSettings = {
   legacyFocusMigrationDismissed: false,
   legacyFocusTagRemovalDismissed: false,
 };
+
+/**
+ * Returns "Next actions" header text from settings if present;
+ * returns a fallback text otherwise.
+ */
+export function nextActionsHeaderText(settings: PluginSettings): string {
+  const headerText = settings.nextActionsHeaderText;
+  if (headerText && headerText.trim().length > 0) {
+    return headerText;
+  }
+  return "Next actions";
+}
+
+/**
+ * Returns "Milestones" header text from settings if present;
+ * returns a fallback text otherwise.
+ */
+export function milestonesHeaderText(settings: PluginSettings): string {
+  const headerText = settings.milestonesHeaderText;
+  if (headerText && headerText.trim().length > 0) {
+    return headerText;
+  }
+  return "Milestones";
+}