@burmese/cursor 3.1.0

package/dist/cursor-rules.js

@@ -0,0 +1,294 @@
+import { randomUUID } from "node:crypto";
+import { chmodSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join, parse, resolve } from "node:path";
+export const maxCursorRulesBytes = 64 * 1024;
+export const cursorRulesStartMarker = "<!-- OPENPETS:CURSOR_RULES:START -->";
+export const cursorRulesEndMarker = "<!-- OPENPETS:CURSOR_RULES:END -->";
+const cursorRulesFrontmatter = "---\ndescription: Use OpenPets MCP tools for lightweight coding-status feedback.\n---";
+export function getCursorProjectRulesPath(projectDir) {
+    return join(projectDir, ".cursor", "rules", "openpets.mdc");
+}
+export function buildCursorOpenPetsRule() {
+    return `${cursorRulesFrontmatter}
+
+${cursorRulesStartMarker}
+# OpenPets status feedback
+
+You may use the OpenPets MCP tools as a brief, safe status channel during meaningful coding work.
+
+- Use \`burmese_say\` sparingly for major milestones, blocking states, completion, or when review is needed.
+- Prefer \`burmese_react\` over speech for lightweight progress such as thinking, working, testing, success, or error.
+- Keep messages short, user-facing, and safe.
+- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through OpenPets.
+- Do not spam every internal step; use OpenPets only for meaningful progress changes and continue normally if a status update is unnecessary.
+- If OpenPets is unavailable, continue the coding task without failing.
+${cursorRulesEndMarker}
+`;
+}
+export function buildCursorRulesPreview() {
+    return buildCursorOpenPetsRule();
+}
+export function readCursorOpenPetsRules(projectDir) {
+    try {
+        const rulesPath = getCursorProjectRulesPath(projectDir);
+        const pathSafety = assertSafeRulesPath(projectDir, rulesPath);
+        if (!pathSafety.ok)
+            return pathSafety;
+        const existing = assertSafeExistingRulesFile(rulesPath, true);
+        if (!existing.ok)
+            return existing;
+        if (!existsSync(rulesPath))
+            return { ok: true, content: "", exists: false };
+        const content = readFileSync(rulesPath, "utf8");
+        if (Buffer.byteLength(content, "utf8") > maxCursorRulesBytes) {
+            return { ok: false, message: "Cursor OpenPets rule file exceeds 64 KiB limit.", reason: "size" };
+        }
+        return { ok: true, content, exists: true };
+    }
+    catch (error) {
+        return { ok: false, message: `IO error: ${error instanceof Error ? error.message : String(error)}`, reason: "io" };
+    }
+}
+export function classifyCursorRulesStatus(readResult, rulesPath, expectedContent = buildCursorOpenPetsRule()) {
+    if (!readResult.ok) {
+        return {
+            status: readResult.reason === "io" ? "error" : "invalid",
+            message: cursorRulesErrorMessage(readResult.reason),
+            rulesPath,
+            canInstall: false,
+            canReplace: false,
+            canRemove: false,
+            redactedDetails: readResult.message,
+        };
+    }
+    if (!readResult.exists) {
+        return {
+            status: "missing",
+            message: "Cursor OpenPets project rule is not installed.",
+            rulesPath,
+            canInstall: true,
+            canReplace: false,
+            canRemove: false,
+            previewContent: expectedContent,
+        };
+    }
+    const managedShape = classifyManagedRuleShape(readResult.content);
+    if (managedShape !== "managed") {
+        return {
+            status: "conflict",
+            message: managedShape,
+            rulesPath,
+            canInstall: false,
+            canReplace: true,
+            canRemove: false,
+            redactedDetails: "Existing .cursor/rules/openpets.mdc is not an exact OpenPets-managed rules file.",
+        };
+    }
+    if (normalizeNewlines(readResult.content) === normalizeNewlines(expectedContent)) {
+        return {
+            status: "installed",
+            message: "Cursor OpenPets project rule is installed and up to date.",
+            rulesPath,
+            canInstall: false,
+            canReplace: false,
+            canRemove: true,
+            previewContent: expectedContent,
+        };
+    }
+    return {
+        status: "needs-update",
+        message: "Cursor OpenPets project rule needs update.",
+        rulesPath,
+        canInstall: true,
+        canReplace: true,
+        canRemove: true,
+        previewContent: expectedContent,
+    };
+}
+export function isManagedCursorOpenPetsRule(content) {
+    return classifyManagedRuleShape(content) === "managed";
+}
+export function planCursorRulesInstall(projectDir, allowReplace = false) {
+    const rulesPath = getCursorProjectRulesPath(projectDir);
+    const existing = readCursorOpenPetsRules(projectDir);
+    if (!existing.ok)
+        return existing;
+    const status = classifyCursorRulesStatus(existing, rulesPath);
+    if (status.status === "invalid" || status.status === "error") {
+        return { ok: false, message: status.message, reason: "io" };
+    }
+    if (status.status === "conflict" && !allowReplace) {
+        return { ok: false, message: "Cannot install: .cursor/rules/openpets.mdc has user content. Use --force to replace only that file.", reason: "unsafe-path" };
+    }
+    if (status.status === "installed") {
+        return { ok: false, message: "Cursor OpenPets project rule is already installed.", reason: "io" };
+    }
+    return buildRulesWritePlan(projectDir, buildCursorOpenPetsRule());
+}
+export function planCursorRulesReplace(projectDir) {
+    const rulesPath = getCursorProjectRulesPath(projectDir);
+    const existing = readCursorOpenPetsRules(projectDir);
+    if (!existing.ok)
+        return existing;
+    const status = classifyCursorRulesStatus(existing, rulesPath);
+    if (status.status === "invalid" || status.status === "error") {
+        return { ok: false, message: status.message, reason: "io" };
+    }
+    if (status.status === "missing") {
+        return { ok: false, message: "Cannot replace: Cursor OpenPets project rule is not installed. Use install instead.", reason: "io" };
+    }
+    if (status.status === "installed") {
+        return { ok: false, message: "Cannot replace: Cursor OpenPets project rule is already installed.", reason: "io" };
+    }
+    return buildRulesWritePlan(projectDir, buildCursorOpenPetsRule());
+}
+export function planCursorRulesRemove(projectDir) {
+    const rulesPath = getCursorProjectRulesPath(projectDir);
+    const existing = readCursorOpenPetsRules(projectDir);
+    if (!existing.ok)
+        return existing;
+    const status = classifyCursorRulesStatus(existing, rulesPath);
+    if (status.status === "missing")
+        return { ok: false, message: "Cursor OpenPets project rule is not installed.", reason: "io" };
+    if (status.status === "conflict")
+        return { ok: false, message: "Cannot remove: .cursor/rules/openpets.mdc is not managed by OpenPets.", reason: "unsafe-path" };
+    if (status.status === "invalid" || status.status === "error")
+        return { ok: false, message: status.message, reason: "io" };
+    return buildRulesWritePlan(projectDir, undefined, true);
+}
+export function executeCursorRulesWrite(plan) {
+    const parent = resolve(plan.targetPath, "..");
+    const parentSafety = assertSafeParentDirectory(parent);
+    if (!parentSafety.ok)
+        throw new Error(parentSafety.message);
+    const targetSafety = assertSafeExistingRulesFile(plan.targetPath, true);
+    if (!targetSafety.ok)
+        throw new Error(targetSafety.message);
+    mkdirSync(parent, { recursive: true, mode: 0o700 });
+    if (plan.backupPath && existsSync(plan.targetPath)) {
+        const backupFd = openSync(plan.backupPath, "wx", 0o600);
+        try {
+            writeFileSync(backupFd, readFileSync(plan.targetPath));
+        }
+        finally {
+            closeSync(backupFd);
+        }
+    }
+    if (plan.remove) {
+        rmSync(plan.targetPath);
+        return;
+    }
+    if (typeof plan.content !== "string")
+        throw new Error("Cursor rules write plan is missing content.");
+    const fd = openSync(plan.tempPath, "wx", 0o600);
+    try {
+        writeFileSync(fd, plan.content, "utf8");
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(plan.tempPath, plan.targetPath);
+    try {
+        chmodSync(plan.targetPath, 0o600);
+    }
+    catch { /* best effort */ }
+}
+function buildRulesWritePlan(projectDir, content, remove = false) {
+    const rulesPath = getCursorProjectRulesPath(projectDir);
+    const pathSafety = assertSafeRulesPath(projectDir, rulesPath);
+    if (!pathSafety.ok)
+        return pathSafety;
+    const existing = assertSafeExistingRulesFile(rulesPath, true);
+    if (!existing.ok)
+        return existing;
+    const parent = resolve(rulesPath, "..");
+    const stamp = `${process.pid}-${Date.now()}-${randomUUID()}`;
+    const backupPath = existsSync(rulesPath) ? uniquePath(`${rulesPath}.openpets-backup-${stamp}.mdc`) : undefined;
+    const tempPath = uniquePath(join(parent, `.openpets-rules-${stamp}.tmp`));
+    return { targetPath: rulesPath, backupPath, tempPath, content, remove };
+}
+function classifyManagedRuleShape(content) {
+    const normalized = normalizeNewlines(content);
+    if (countOccurrences(normalized, cursorRulesStartMarker) !== 1 || countOccurrences(normalized, cursorRulesEndMarker) !== 1) {
+        return "Cursor OpenPets rule file has missing or duplicate managed markers.";
+    }
+    const start = normalized.indexOf(cursorRulesStartMarker);
+    const end = normalized.indexOf(cursorRulesEndMarker);
+    if (start < 0 || end < 0 || start > end)
+        return "Cursor OpenPets rule file has malformed managed markers.";
+    const before = normalized.slice(0, start).trim();
+    const after = normalized.slice(end + cursorRulesEndMarker.length).trim();
+    if (before !== cursorRulesFrontmatter)
+        return "Cursor OpenPets rule file has unknown frontmatter or user content before the managed block.";
+    if (after !== "")
+        return "Cursor OpenPets rule file has user content after the managed block.";
+    return "managed";
+}
+function cursorRulesErrorMessage(reason) {
+    const messages = {
+        size: "Cursor OpenPets rule file is too large.",
+        symlink: "Cursor OpenPets rule path is a symlink.",
+        "not-regular": "Cursor OpenPets rule path is not a regular file.",
+        "unsafe-path": "Cursor OpenPets rule path is unsafe.",
+        io: "Failed to read Cursor OpenPets rule file.",
+    };
+    return messages[reason];
+}
+function assertSafeRulesPath(projectDir, rulesPath) {
+    const projectRoot = resolve(projectDir);
+    const expected = resolve(getCursorProjectRulesPath(projectRoot));
+    const resolvedRulesPath = resolve(rulesPath);
+    if (resolvedRulesPath !== expected) {
+        return { ok: false, message: "Cursor rules path must be <project>/.cursor/rules/openpets.mdc.", reason: "unsafe-path" };
+    }
+    return assertSafeParentDirectory(resolve(rulesPath, ".."));
+}
+function assertSafeExistingRulesFile(path, allowMissing = false) {
+    const stat = lstatSync(path, { throwIfNoEntry: false });
+    if (!stat)
+        return allowMissing ? { ok: true } : { ok: false, message: "Cursor rules file does not exist.", reason: "io" };
+    if (stat.isSymbolicLink())
+        return { ok: false, message: "Cursor rules file is a symlink.", reason: "symlink" };
+    if (!stat.isFile())
+        return { ok: false, message: "Cursor rules path is not a regular file.", reason: "not-regular" };
+    if (stat.size > maxCursorRulesBytes)
+        return { ok: false, message: "Cursor rules file exceeds 64 KiB limit.", reason: "size" };
+    return { ok: true };
+}
+function assertSafeParentDirectory(path) {
+    if (path.split(/[\\/]+/u).includes("..")) {
+        return { ok: false, message: "Cursor rules parent path must not contain parent traversal segments.", reason: "unsafe-path" };
+    }
+    const absolutePath = resolve(path);
+    const root = parse(absolutePath).root;
+    const parts = absolutePath.slice(root.length).split(/[\\/]+/u).filter(Boolean);
+    let current = root;
+    for (const part of parts) {
+        current = join(current, part);
+        const stat = lstatSync(current, { throwIfNoEntry: false });
+        if (!stat)
+            break;
+        if (stat.isSymbolicLink())
+            return { ok: false, message: "Cursor rules parent must not contain symlink segments.", reason: "symlink" };
+        if (!stat.isDirectory())
+            return { ok: false, message: "Cursor rules parent path segment must be a directory.", reason: "unsafe-path" };
+    }
+    return { ok: true };
+}
+function uniquePath(path) {
+    if (!existsSync(path))
+        return path;
+    for (let index = 1; index < 1000; index += 1) {
+        const candidate = `${path}.${index}`;
+        if (!existsSync(candidate))
+            return candidate;
+    }
+    throw new Error("Unable to allocate unique temp path.");
+}
+function normalizeNewlines(value) {
+    return value.replace(/\r\n?/g, "\n");
+}
+function countOccurrences(value, needle) {
+    return value.split(needle).length - 1;
+}
+//# sourceMappingURL=cursor-rules.js.map

package/dist/cursor-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.js","sourceRoot":"","sources":["../src/cursor-rules.ts"],"names":[],"mappings":"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"}

package/dist/cursor-status.d.ts

@@ -0,0 +1,37 @@
+import { type CursorMcpEntry, type CursorMcpPreviewOptions } from "./cursor-mcp.js";
+export type CursorMcpStatus = "missing" | "installed" | "needs-update" | "conflict" | "invalid" | "error";
+export interface CursorMcpStatusResult {
+    readonly status: CursorMcpStatus;
+    readonly message: string;
+    readonly configPath: string;
+    readonly canInstall: boolean;
+    readonly canReplace: boolean;
+    readonly canRemove: boolean;
+    readonly previewEntry?: CursorMcpEntry;
+    readonly redactedDetails?: string;
+}
+export interface CursorConfigReadResult {
+    readonly ok: true;
+    readonly config: Record<string, unknown>;
+    readonly exists: boolean;
+}
+export interface CursorConfigError {
+    readonly ok: false;
+    readonly message: string;
+    readonly reason: "parse" | "size" | "symlink" | "not-regular" | "unsafe-path" | "invalid-schema" | "io";
+}
+export interface CursorPlannedWrite {
+    readonly targetPath: string;
+    readonly backupPath?: string;
+    readonly tempPath: string;
+    readonly content: string;
+}
+export declare const maxCursorConfigBytes: number;
+export declare function classifyCursorMcpStatus(configResult: CursorConfigReadResult | CursorConfigError, configPath: string, expected: CursorMcpPreviewOptions): CursorMcpStatusResult;
+export declare function isManagedOpenPetsMcpEntry(value: unknown): boolean;
+export declare function readCursorMcpConfig(configPath: string): CursorConfigReadResult | CursorConfigError;
+export declare function planCursorMcpInstall(configPath: string, options: CursorMcpPreviewOptions, allowReplace?: boolean): CursorPlannedWrite | CursorConfigError;
+export declare function planCursorMcpReplace(configPath: string, options: CursorMcpPreviewOptions): CursorPlannedWrite | CursorConfigError;
+export declare function planCursorMcpRemove(configPath: string): CursorPlannedWrite | CursorConfigError;
+export declare function executeCursorMcpWrite(plan: CursorPlannedWrite): void;
+//# sourceMappingURL=cursor-status.d.ts.map

package/dist/cursor-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-status.d.ts","sourceRoot":"","sources":["../src/cursor-status.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAAqC,MAAM,iBAAiB,CAAC;AAE5I,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1G,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAAC;CACzG;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAE/C,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,sBAAsB,GAAG,iBAAiB,EACxD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,GAChC,qBAAqB,CAmGvB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBjE;AAwCD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,GAAG,iBAAiB,CAsClG;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,EAChC,YAAY,UAAQ,GACnB,kBAAkB,GAAG,iBAAiB,CA6BxC;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,GAC/B,kBAAkB,GAAG,iBAAiB,CA4BxC;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,CAqB9F;AAiBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAkCpE"}