pi-config/extensions/plannotator/server/integrations.ts

/**
 * Note-taking app integrations (Obsidian, Bear, Octarine).
 * Node.js equivalents of packages/server/integrations.ts.
 * Config types, save functions, tag extraction, filename generation
 */

import { execSync, spawn } from "node:child_process";
import { existsSync, mkdirSync, statSync, writeFileSync } from "node:fs";
import { basename, join } from "node:path";

import {
	type ObsidianConfig,
	type BearConfig,
	type OctarineConfig,
	type IntegrationResult,
	extractTitle,
	generateFrontmatter,
	generateFilename,
	generateOctarineFrontmatter,
	stripH1,
	buildHashtags,
	buildBearContent,
	detectObsidianVaults,
} from "../generated/integrations-common.js";
import { sanitizeTag } from "../generated/project.js";
import { resolveUserPath } from "../generated/resolve-file.js";

export type { ObsidianConfig, BearConfig, OctarineConfig, IntegrationResult };
export {
	extractTitle,
	generateFrontmatter,
	generateFilename,
	generateOctarineFrontmatter,
	stripH1,
	buildHashtags,
	buildBearContent,
	detectObsidianVaults,
};

/** Detect project name from git or cwd (sync). Used by extractTags for note integrations. */
function detectProjectNameSync(): string | null {
	try {
		const toplevel = execSync("git rev-parse --show-toplevel", {
			encoding: "utf-8",
			stdio: ["pipe", "pipe", "pipe"],
		}).trim();
		if (toplevel) {
			const name = sanitizeTag(basename(toplevel));
			if (name) return name;
		}
	} catch {
		/* not in a git repo */
	}
	try {
		return sanitizeTag(basename(process.cwd())) ?? null;
	} catch {
		return null;
	}
}

export async function extractTags(markdown: string): Promise<string[]> {
	const tags = new Set<string>(["plannotator"]);
	const projectName = detectProjectNameSync();
	if (projectName) tags.add(projectName);
	const stopWords = new Set([
		"the",
		"and",
		"for",
		"with",
		"this",
		"that",
		"from",
		"into",
		"plan",
		"implementation",
		"overview",
		"phase",
		"step",
		"steps",
	]);
	const h1Match = markdown.match(
		/^#\s+(?:Implementation\s+Plan:|Plan:)?\s*(.+)$/im,
	);
	if (h1Match) {
		h1Match[1]
			.toLowerCase()
			.replace(/[^\w\s-]/g, " ")
			.split(/\s+/)
			.filter((w) => w.length > 2 && !stopWords.has(w))
			.slice(0, 3)
			.forEach((w) => tags.add(w));
	}
	const seenLangs = new Set<string>();
	let langMatch: RegExpExecArray | null;
	const langRegex = /```(\w+)/g;
	while ((langMatch = langRegex.exec(markdown)) !== null) {
		const lang = langMatch[1];
		const n = lang.toLowerCase();
		if (
			!seenLangs.has(n) &&
			!["json", "yaml", "yml", "text", "txt", "markdown", "md"].includes(n)
		) {
			seenLangs.add(n);
			tags.add(n);
		}
	}
	return Array.from(tags).slice(0, 7);
}

export async function saveToObsidian(
	config: ObsidianConfig,
): Promise<IntegrationResult> {
	try {
		const { vaultPath, folder, plan } = config;
		if (!vaultPath?.trim()) {
			return { success: false, error: "Vault path is required" };
		}
		const normalizedVault = resolveUserPath(vaultPath);
		if (!existsSync(normalizedVault))
			return {
				success: false,
				error: `Vault path does not exist: ${normalizedVault}`,
			};
		if (!statSync(normalizedVault).isDirectory())
			return {
				success: false,
				error: `Vault path is not a directory: ${normalizedVault}`,
			};
		const folderName = folder.trim() || "plannotator";
		const targetFolder = join(normalizedVault, folderName);
		if (!existsSync(targetFolder)) mkdirSync(targetFolder, { recursive: true });
		const filename = generateFilename(
			plan,
			config.filenameFormat,
			config.filenameSeparator,
		);
		const filePath = join(targetFolder, filename);
		const tags = await extractTags(plan);
		const frontmatter = generateFrontmatter(tags);
		const content = `${frontmatter}\n\n[[Plannotator Plans]]\n\n${plan}`;
		writeFileSync(filePath, content);
		return { success: true, path: filePath };
	} catch (err) {
		return {
			success: false,
			error: err instanceof Error ? err.message : "Unknown error",
		};
	}
}

export async function saveToBear(
	config: BearConfig,
): Promise<IntegrationResult> {
	try {
		const { plan, customTags, tagPosition = "append" } = config;
		const title = extractTitle(plan);
		const body = stripH1(plan);
		const tags = customTags?.trim() ? undefined : await extractTags(plan);
		const hashtags = buildHashtags(customTags, tags ?? []);
		const content = buildBearContent(body, hashtags, tagPosition);
		const url = `bear://x-callback-url/create?title=${encodeURIComponent(title)}&text=${encodeURIComponent(content)}&open_note=no`;
		spawn("open", [url], { stdio: "ignore" });
		return { success: true };
	} catch (err) {
		return {
			success: false,
			error: err instanceof Error ? err.message : "Unknown error",
		};
	}
}

export async function saveToOctarine(
	config: OctarineConfig,
): Promise<IntegrationResult> {
	try {
		const { plan } = config;
		const workspace = config.workspace.trim();
		if (!workspace) return { success: false, error: "Workspace is required" };
		const folder = config.folder.trim() || "plannotator";
		const filename = generateFilename(plan);
		const base = filename.replace(/\.md$/, "");
		const path = folder ? `${folder}/${base}` : base;
		const tags = await extractTags(plan);
		const frontmatter = generateOctarineFrontmatter(tags);
		const content = `${frontmatter}\n\n${plan}`;
		const url = `octarine://create?path=${encodeURIComponent(path)}&content=${encodeURIComponent(content)}&workspace=${encodeURIComponent(workspace)}&fresh=true&openAfter=false`;
		spawn("open", [url], { stdio: "ignore" });
		return { success: true, path };
	} catch (err) {
		return {
			success: false,
			error: err instanceof Error ? err.message : "Unknown error",
		};
	}
}