@brainervirus/workit-core 0.6.0 → 0.6.1

package/src/core/hygiene.ts

@@ -3,7 +3,13 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { changelogUnreleasedStats } from "./changelog";
 
-export type HygieneFile = "CHANGELOG.md" | "README.md" | ".editorconfig" | ".gitattributes" | "LICENSE" | "CONTRIBUTING.md";
+export type HygieneFile =
+  | "CHANGELOG.md"
+  | "README.md"
+  | ".editorconfig"
+  | ".gitattributes"
+  | "LICENSE"
+  | "CONTRIBUTING.md";
 type State = "missing" | "invalid" | "ok" | "skip";
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
@@ -11,7 +17,11 @@ const templatesDir = () => path.join(repoRoot, "templates", "hygiene");
 
 const packageJson = (root: string): Record<string, unknown> | null => {
   if (!existsSync(path.join(root, "package.json"))) return null;
-  try { return JSON.parse(readFileSync(path.join(root, "package.json"), "utf8")); } catch { return null; }
+  try {
+    return JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
+  } catch {
+    return null;
+  }
 };
 
 const isOpenSource = (root: string): boolean => {
@@ -34,15 +44,27 @@ const licenseHolder = (root: string): string => {
   return "";
 };
 
-export const hygieneFiles = (root: string): { state: Record<HygieneFile, State>; openSource: boolean } => {
+export const hygieneFiles = (
+  root: string,
+): { state: Record<HygieneFile, State>; openSource: boolean } => {
   const openSource = isOpenSource(root);
   const state = {} as Record<HygieneFile, State>;
-  for (const file of ["CHANGELOG.md", "README.md", ".editorconfig", ".gitattributes", "LICENSE", "CONTRIBUTING.md"] as HygieneFile[]) {
+  for (const file of [
+    "CHANGELOG.md",
+    "README.md",
+    ".editorconfig",
+    ".gitattributes",
+    "LICENSE",
+    "CONTRIBUTING.md",
+  ] as HygieneFile[]) {
     if (file === "LICENSE" || file === "CONTRIBUTING.md") {
       state[file] = openSource ? (existsSync(path.join(root, file)) ? "ok" : "missing") : "skip";
       continue;
     }
-    if (!existsSync(path.join(root, file))) { state[file] = "missing"; continue; }
+    if (!existsSync(path.join(root, file))) {
+      state[file] = "missing";
+      continue;
+    }
     if (file === "CHANGELOG.md") {
       const stats = changelogUnreleasedStats(root);
       state[file] = stats.exists && stats.has_unreleased ? "ok" : "invalid";

package/src/core/init.ts

@@ -9,7 +9,11 @@ import { youTrackTokenCreateUrl, youTrackVerifyToken } from "./youtrack";
 const TOKEN_PLACEHOLDER = "YOUR_TOKEN_HERE";
 
 const readJson = (p: string): Record<string, any> | null => {
-  try { return JSON.parse(fs.readFileSync(p, "utf8")) as Record<string, any>; } catch { return null; }
+  try {
+    return JSON.parse(fs.readFileSync(p, "utf8")) as Record<string, any>;
+  } catch {
+    return null;
+  }
 };
 
 const isPlaceholder = (text: string): boolean =>
@@ -19,7 +23,11 @@ const modeOk = (p: string): boolean =>
   process.platform === "win32" || (fs.statSync(p).mode & 0o777) === 0o600;
 
 const resolvePath = (p: string): string => {
-  try { return fs.realpathSync(p); } catch { return path.resolve(p); }
+  try {
+    return fs.realpathSync(p);
+  } catch {
+    return path.resolve(p);
+  }
 };
 
 /** Port of scripts/init/status.sh — filesystem init state. */
@@ -50,11 +58,14 @@ export function initStatusData(configDirPath = configDir()): Record<string, any>
       }
     }
     const expanded = tokenFile ? path.resolve(tokenFile) : null;
-    const resolvedTokenFile = expanded && fs.existsSync(expanded)
-      ? resolvePath(expanded)
-      : expanded
-        ? (path.isAbsolute(expanded) ? expanded : path.resolve(configDirPath, expanded))
-        : null;
+    const resolvedTokenFile =
+      expanded && fs.existsSync(expanded)
+        ? resolvePath(expanded)
+        : expanded
+          ? path.isAbsolute(expanded)
+            ? expanded
+            : path.resolve(configDirPath, expanded)
+          : null;
     youtrackConfig = {
       config_edit_path: resolvePath(ytJson),
       baseUrl: base,
@@ -67,8 +78,18 @@ export function initStatusData(configDirPath = configDir()): Record<string, any>
       tokenFile: resolvedTokenFile,
       tokenDefaults: ytParsed.tokenDefaults,
       timeLogging: {
-        meetings: { options: meetingIssues, skill: "/wk-meetings", logsTime: true, postsComment: false },
-        taskWork: { issueSource: "active spec/plan **YouTrack:** field or --issue", skill: "/wk-issue-update", logsTime: true, postsComment: true },
+        meetings: {
+          options: meetingIssues,
+          skill: "/wk-meetings",
+          logsTime: true,
+          postsComment: false,
+        },
+        taskWork: {
+          issueSource: "active spec/plan **YouTrack:** field or --issue",
+          skill: "/wk-issue-update",
+          logsTime: true,
+          postsComment: true,
+        },
       },
     };
     youtrackTokenCreate = youTrackTokenCreateUrl().data;
@@ -91,20 +112,28 @@ export function initStatusData(configDirPath = configDir()): Record<string, any>
   const ytTokenPath = youtrackConfig?.tokenFile ?? path.join(configDirPath, "youtrack.token");
   const tokenText = fs.existsSync(ytTokenPath) ? fs.readFileSync(ytTokenPath, "utf8").trim() : "";
   const placeholder = fs.existsSync(ytTokenPath) && isPlaceholder(tokenText);
-  const tokenOk = fs.existsSync(ytTokenPath) && modeOk(ytTokenPath) && Boolean(tokenText) && !isPlaceholder(tokenText);
+  const tokenOk =
+    fs.existsSync(ytTokenPath) &&
+    modeOk(ytTokenPath) &&
+    Boolean(tokenText) &&
+    !isPlaceholder(tokenText);
 
   const youtrackTokenItem: Record<string, any> = {
     id: "youtrack_token",
     label: "YouTrack API token (mode 600, not placeholder)",
     ok: tokenOk,
     path: fs.existsSync(ytTokenPath) ? resolvePath(ytTokenPath) : path.resolve(ytTokenPath),
-    token_edit_path: fs.existsSync(ytTokenPath) ? resolvePath(ytTokenPath) : path.resolve(ytTokenPath),
+    token_edit_path: fs.existsSync(ytTokenPath)
+      ? resolvePath(ytTokenPath)
+      : path.resolve(ytTokenPath),
     placeholder,
     fix: `Open ${resolvePath(ytTokenPath)} — replace ${TOKEN_PLACEHOLDER} with your permanent token, save, then /wk-status`,
   };
   if (youtrackTokenCreate) {
-    if (youtrackTokenCreate.createUrl) youtrackTokenItem.token_create_url = youtrackTokenCreate.createUrl;
-    if (youtrackTokenCreate.docsUrl) youtrackTokenItem.token_create_docs_url = youtrackTokenCreate.docsUrl;
+    if (youtrackTokenCreate.createUrl)
+      youtrackTokenItem.token_create_url = youtrackTokenCreate.createUrl;
+    if (youtrackTokenCreate.docsUrl)
+      youtrackTokenItem.token_create_docs_url = youtrackTokenCreate.docsUrl;
     if (youtrackTokenCreate.scopes) youtrackTokenItem.token_scopes = youtrackTokenCreate.scopes;
     if (youtrackTokenCreate.tokenName) youtrackTokenItem.token_name = youtrackTokenCreate.tokenName;
     if (youtrackTokenCreate.steps) youtrackTokenItem.token_create_steps = youtrackTokenCreate.steps;
@@ -181,8 +210,22 @@ export function initStatusData(configDirPath = configDir()): Record<string, any>
   for (const k of ["gitlab", "github"]) {
     vcsTokenFiles[k] = String(vcsParsed?.[k]?.tokenFile ?? path.join(configDirPath, `${k}.token`));
   }
-  items.push(tokenItem("gitlab_token", "GitLab token (mode 600, not placeholder)", vcsTokenFiles.gitlab, "gitlab"));
-  items.push(tokenItem("github_token", "GitHub token (mode 600, not placeholder)", vcsTokenFiles.github, "github"));
+  items.push(
+    tokenItem(
+      "gitlab_token",
+      "GitLab token (mode 600, not placeholder)",
+      vcsTokenFiles.gitlab,
+      "gitlab",
+    ),
+  );
+  items.push(
+    tokenItem(
+      "github_token",
+      "GitHub token (mode 600, not placeholder)",
+      vcsTokenFiles.github,
+      "github",
+    ),
+  );
 
   return {
     config_dir: configDirPath,
@@ -218,7 +261,8 @@ export function toolkitStatusData(configDirPath = configDir()): Record<string, a
   status.youtrack_verify = verify;
   status.youtrack_ok = placeholder ? false : Boolean((verify as Record<string, any>).ok);
   status.vcs_verify = vcsVerify;
-  status.vcs_ok = vcsJsonOk && !vcsPlaceholder ? Boolean((vcsVerify as Record<string, any>).ok) : false;
+  status.vcs_ok =
+    vcsJsonOk && !vcsPlaceholder ? Boolean((vcsVerify as Record<string, any>).ok) : false;
 
   const fsReady = status.items.every((i: Record<string, any>) => i.required === false || i.ok);
   status.ready = fsReady && Boolean(status.youtrack_ok) && (!vcsJsonOk || Boolean(status.vcs_ok));
@@ -302,7 +346,10 @@ const vcsJsonContent = (dir: string): Record<string, any> => ({
 });
 
 /** Port of scripts/init/apply.sh — confirmed scaffold actions. */
-export function initApplyData(action: string, env: NodeJS.ProcessEnv = process.env): Record<string, any> {
+export function initApplyData(
+  action: string,
+  env: NodeJS.ProcessEnv = process.env,
+): Record<string, any> {
   const dir = String(env.WORKFLOW_TOOLKIT_CONFIG ?? configDir());
   fs.mkdirSync(dir, { recursive: true });
 
@@ -360,7 +407,12 @@ export function initApplyData(action: string, env: NodeJS.ProcessEnv = process.e
             locale: cfg.locale,
             tokenCreate,
             timeLogging: {
-              meetings: { issue: meeting, skill: "/wk-meetings", logsTime: true, postsComment: false },
+              meetings: {
+                issue: meeting,
+                skill: "/wk-meetings",
+                logsTime: true,
+                postsComment: false,
+              },
               taskWork: {
                 issueSource: "active spec/plan **YouTrack:** field or --issue",
                 skill: "/wk-issue-update",
@@ -421,21 +473,34 @@ export function initApplyData(action: string, env: NodeJS.ProcessEnv = process.e
       }
     }
     default: {
-      return { error: `unknown action ${action} (youtrack_scaffold|youtrack_json|youtrack_token_placeholder|vcs_scaffold)` };
+      return {
+        error: `unknown action ${action} (youtrack_scaffold|youtrack_json|youtrack_token_placeholder|vcs_scaffold)`,
+      };
     }
   }
 }
 
 export function initStatus(): Record<string, any> {
   const data = initStatusData();
-  return { ...data, workspaces: { resolved: resolveWorkspace(process.cwd()), path: workspacesPath() } };
+  return {
+    ...data,
+    workspaces: { resolved: resolveWorkspace(process.cwd()), path: workspacesPath() },
+  };
 }
 
 export function toolkitStatus(): Record<string, any> {
   return toolkitStatusData();
 }
 
-export function initApply({ action, confirmed, env }: { action: string; confirmed: boolean; env?: Record<string, string> }): Record<string, any> {
+export function initApply({
+  action,
+  confirmed,
+  env,
+}: {
+  action: string;
+  confirmed: boolean;
+  env?: Record<string, string>;
+}): Record<string, any> {
   if (!confirmed) return { error: "confirmed: true required" };
   return { data: initApplyData(action, env ? { ...process.env, ...env } : process.env) };
 }

package/src/core/parse-sections.ts

@@ -3,7 +3,7 @@ export function parseSections(stdout: string): Record<string, string> {
   const sections: Record<string, string> = {};
   const parts = stdout.split(/\n## /);
   for (const part of parts.slice(1)) {
-    const nl = part.indexOf('\n');
+    const nl = part.indexOf("\n");
     const title = part.slice(0, nl).trim();
     sections[title] = part.slice(nl + 1).trim();
   }
@@ -12,7 +12,7 @@ export function parseSections(stdout: string): Record<string, string> {
 
 export function parseKeyValueLines(text: string, keys: string[]): Record<string, string> {
   const out: Record<string, string> = {};
-  for (const line of text.split('\n')) {
+  for (const line of text.split("\n")) {
     for (const key of keys) {
       const prefix = `${key}: `;
       if (line.startsWith(prefix)) {

package/src/core/plan-tasks.ts

@@ -4,13 +4,19 @@ import { parseTasksFromPlan } from "./docs-validate";
 import { resolveBranch } from "./branch";
 
 const readSafe = (p: string): string | null => {
-  try { return readFileSync(p, "utf8"); } catch { return null; }
+  try {
+    return readFileSync(p, "utf8");
+  } catch {
+    return null;
+  }
 };
 
 export function parsePlanTasks(
   planPath: string,
   workspaceRoot: string,
-): { task_count: number; tasks: { id: number; title: string; section_text: string }[] } | { error: string } {
+):
+  | { task_count: number; tasks: { id: number; title: string; section_text: string }[] }
+  | { error: string } {
   const cwd = path.resolve(workspaceRoot);
   const resolved = path.isAbsolute(planPath) ? planPath : path.join(cwd, planPath);
   const text = readSafe(resolved);
@@ -27,7 +33,11 @@ export function resolveHandoffBranch(
   planPath: string,
   workspaceRoot: string,
 ): { branch: string } | { error: string } {
-  const resolved = resolveBranch({ spec_path: specPath, plan_path: planPath, workspace_root: workspaceRoot });
+  const resolved = resolveBranch({
+    spec_path: specPath,
+    plan_path: planPath,
+    workspace_root: workspaceRoot,
+  });
   if ("error" in resolved) return { error: resolved.error as string };
   return { branch: resolved.branch };
 }

package/src/core/ports/youtrack-api.ts

@@ -5,7 +5,9 @@ const args = process.argv.slice(2);
 const cmd = args[0];
 if (cmd === "log-time" || cmd === "post-comment") {
   if ((process.env.WORKFLOW_YT_WRITE ?? "") !== "1") {
-    console.error("ERROR: YouTrack write operations require WORKFLOW_YT_WRITE=1 (refusing to mutate production)");
+    console.error(
+      "ERROR: YouTrack write operations require WORKFLOW_YT_WRITE=1 (refusing to mutate production)",
+    );
     process.exit(1);
   }
 }

package/src/core/ports/youtrack-config.ts

@@ -1,7 +1,5 @@
 // CLI port of scripts/youtrack/config.sh — JSON out, argv/env in.
-import {
-  youTrackConfigLoad,
-} from "../youtrack";
+import { youTrackConfigLoad } from "../youtrack";
 
 const args = process.argv.slice(2);
 const cmd = args[0] ?? "load";

package/src/core/pr-create.ts

@@ -61,7 +61,8 @@ function buildBody(
   return body ? `${body}\n\n${line}` : line;
 }
 
-const truthy = (v: string | undefined): boolean => ["1", "true", "yes"].includes(String(v ?? "").toLowerCase());
+const truthy = (v: string | undefined): boolean =>
+  ["1", "true", "yes"].includes(String(v ?? "").toLowerCase());
 
 // Port of python's shutil.which — scan PATH in-process (no `which` binary needed).
 function whichOnPath(tool: string): string | null {
@@ -71,7 +72,9 @@ function whichOnPath(tool: string): string | null {
     try {
       fs.accessSync(candidate, fs.constants.X_OK);
       return candidate;
-    } catch { /* keep scanning */ }
+    } catch {
+      /* keep scanning */
+    }
   }
   return null;
 }
@@ -107,12 +110,15 @@ export function prCreate(env: NodeJS.ProcessEnv, cwd: string): Record<string, an
   const root = process.env.WORKFLOW_WORKSPACE_ROOT ?? repoRoot(cwd);
   const cfg = vcsConfig("load", root);
   if (!cfg.ok) return { error: cfg.error ?? "vcs config missing" };
-  if (!cfg.tokenReady) return { error: "VCS token not ready — run /wk-init and edit token file locally" };
+  if (!cfg.tokenReady)
+    return { error: "VCS token not ready — run /wk-init and edit token file locally" };
 
   const provider = cfg.provider as string;
-  if (provider !== "gitlab" && provider !== "github") return { error: `unsupported provider: ${provider}` };
+  if (provider !== "gitlab" && provider !== "github")
+    return { error: `unsupported provider: ${provider}` };
   const cli = provider === "gitlab" ? "glab" : "gh";
-  const installUrl = provider === "gitlab" ? "https://gitlab.com/gitlab-org/cli" : "https://cli.github.com";
+  const installUrl =
+    provider === "gitlab" ? "https://gitlab.com/gitlab-org/cli" : "https://cli.github.com";
   if (whichOnPath(cli) === null) {
     return {
       ok: false,
@@ -129,16 +135,23 @@ export function prCreate(env: NodeJS.ProcessEnv, cwd: string): Record<string, an
   const draft = String(env.WF_PR_DRAFT ?? "false").toLowerCase() === "true";
   const target = env.WF_PR_TARGET || String(cfg.defaultTargetBranch ?? "develop");
 
-  const br = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: root, encoding: "utf8" });
+  const br = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+    cwd: root,
+    encoding: "utf8",
+  });
   const branch = br.status === 0 ? (br.stdout ?? "").trim() : "";
 
   let baseUrl = cfg.youtrack_base_url as string | undefined;
   if (!baseUrl) {
-    const ytCfg = process.env.WORKFLOW_YOUTRACK_CONFIG ?? path.join(path.dirname(String(cfg.configPath)), "youtrack.json");
+    const ytCfg =
+      process.env.WORKFLOW_YOUTRACK_CONFIG ??
+      path.join(path.dirname(String(cfg.configPath)), "youtrack.json");
     try {
       const yt = JSON.parse(fs.readFileSync(ytCfg, "utf8")) as Record<string, any>;
       if (yt && typeof yt === "object") baseUrl = yt.baseUrl;
-    } catch { /* optional */ }
+    } catch {
+      /* optional */
+    }
   }
   const ghLinkOnPr = cfg.issues_provider === "github" && cfg.link_on_pr === true;
   let ghRepo: string | null = null;
@@ -147,8 +160,15 @@ export function prCreate(env: NodeJS.ProcessEnv, cwd: string): Record<string, an
     if (rr.status === 0) ghRepo = parseGhRepo(rr.stdout ?? "");
   }
   const finalBody = buildBody(
-    body, branch, cfg.link_issues === true, baseUrl ?? "", env.WORKFLOW_YT_ISSUE ?? "",
-    ghLinkOnPr, env.WORKFLOW_GH_ISSUE ?? "", env.WORKFLOW_GH_ISSUE_RELATION ?? "closes", ghRepo,
+    body,
+    branch,
+    cfg.link_issues === true,
+    baseUrl ?? "",
+    env.WORKFLOW_YT_ISSUE ?? "",
+    ghLinkOnPr,
+    env.WORKFLOW_GH_ISSUE ?? "",
+    env.WORKFLOW_GH_ISSUE_RELATION ?? "closes",
+    ghRepo,
   );
 
   const squash = pr.squashOnMerge !== false;
@@ -178,9 +198,15 @@ export function prCreate(env: NodeJS.ProcessEnv, cwd: string): Record<string, an
   if (result.status !== 0) {
     const err = (result.stderr ?? result.stdout ?? "").trim();
     let hint: Record<string, any> | null = null;
-    if (provider === "gitlab" && (err.includes("409") || err.toLowerCase().includes("already exists"))) {
-      const list = spawnSync("glab", ["mr", "list", `--source-branch=${branch}`, "--output=json"],
-        { cwd: root, encoding: "utf8", env: cmdEnv });
+    if (
+      provider === "gitlab" &&
+      (err.includes("409") || err.toLowerCase().includes("already exists"))
+    ) {
+      const list = spawnSync("glab", ["mr", "list", `--source-branch=${branch}`, "--output=json"], {
+        cwd: root,
+        encoding: "utf8",
+        env: cmdEnv,
+      });
       if (list.status === 0 && (list.stdout ?? "").trim()) {
         try {
           const mrs = JSON.parse(list.stdout ?? "") as Array<Record<string, any>>;
@@ -191,10 +217,16 @@ export function prCreate(env: NodeJS.ProcessEnv, cwd: string): Record<string, an
               next_step: "Use glab mr update or close the open MR before creating again",
             };
           }
-        } catch { /* no hint */ }
+        } catch {
+          /* no hint */
+        }
       }
     }
-    const payload: Record<string, any> = { error: "create failed", provider, stderr: err.slice(0, 800) };
+    const payload: Record<string, any> = {
+      error: "create failed",
+      provider,
+      stderr: err.slice(0, 800),
+    };
     if (hint) payload.hint = hint;
     return payload;
   }

package/src/core/present.ts

@@ -30,7 +30,12 @@ export function renderAsciiWireframe(spec: unknown): string {
     }
     if (kind === "button") {
       const label = "[ " + String(row?.label ?? "Button") + " ]";
-      lines.push(boxLine(label.padStart(Math.max(0, (width - 4 + label.length) / 2)).padEnd(width - 4), width));
+      lines.push(
+        boxLine(
+          label.padStart(Math.max(0, (width - 4 + label.length) / 2)).padEnd(width - 4),
+          width,
+        ),
+      );
       continue;
     }
     if (kind === "field") {
@@ -42,7 +47,11 @@ export function renderAsciiWireframe(spec: unknown): string {
     if (kind === "columns") {
       const cols = Array.isArray(row?.columns) ? row.columns : [];
       const colW = Math.floor((width - 4 - cols.length + 1) / Math.max(cols.length, 1));
-      const parts = cols.map((c: any) => String(c?.label ?? "").slice(0, Math.max(0, colW - 1)).padEnd(Math.max(0, colW)));
+      const parts = cols.map((c: any) =>
+        String(c?.label ?? "")
+          .slice(0, Math.max(0, colW - 1))
+          .padEnd(Math.max(0, colW)),
+      );
       lines.push(boxLine(parts.join(" | ").trim(), width));
       continue;
     }

package/src/core/reminder.ts

@@ -57,8 +57,7 @@ Skill: receiving-code-review. Verify before implementing — evaluate review fee
 export const shouldInjectVerification = (currentText: string): boolean =>
   !currentText.includes(VERIFICATION_TEXT);
 
-export const shouldInjectTdd = (currentText: string): boolean =>
-  !currentText.includes(TDD_TEXT);
+export const shouldInjectTdd = (currentText: string): boolean => !currentText.includes(TDD_TEXT);
 
 export const shouldInjectBrainstorm = (currentText: string): boolean =>
   !currentText.includes(BRAINSTORM_TEXT);

package/src/core/repo-tool.ts

@@ -1,7 +1,10 @@
 import { resolveWorkspaceRoot } from "./scripts";
 
 /** Attach the resolved repository root to each repository tool response. */
-export function withWorkspace(workspaceRoot: string, data: Record<string, any> = {}): Record<string, any> {
+export function withWorkspace(
+  workspaceRoot: string,
+  data: Record<string, any> = {},
+): Record<string, any> {
   return {
     workspace_root: resolveWorkspaceRoot(workspaceRoot),
     ...data,

package/src/core/rules.ts

@@ -1,6 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 import { configDir } from "./config";
 
 export type RulePlatform = "cursor" | "opencode";
@@ -11,13 +10,12 @@ export type CanonicalRule = {
   body: string;
 };
 
-const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
-
 export const rulesDir = () => path.join(configDir(), "rules");
 
 export const parseRule = (markdown: string): CanonicalRule | { error: string } => {
   const fm = markdown.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-  if (!fm) return { error: "rule must start with frontmatter (--- name/description/platforms ---)" };
+  if (!fm)
+    return { error: "rule must start with frontmatter (--- name/description/platforms ---)" };
   const meta: Record<string, string> = {};
   const unquote = (v: string) => v.replace(/^["']|["']$/g, "").trim();
   for (const line of fm[1].split("\n")) {
@@ -27,9 +25,13 @@ export const parseRule = (markdown: string): CanonicalRule | { error: string } =
   const name = meta.name ?? "";
   const description = meta.description ?? "";
   const rawPlatforms = (meta.platforms ?? "")
-    .replace(/^\[|\]$/g, "").split(",").map((p) => p.trim().replace(/['"]/g, ""))
+    .replace(/^\[|\]$/g, "")
+    .split(",")
+    .map((p) => p.trim().replace(/['"]/g, ""))
     .filter(Boolean);
-  const platforms = rawPlatforms.filter((p): p is RulePlatform => p === "cursor" || p === "opencode");
+  const platforms = rawPlatforms.filter(
+    (p): p is RulePlatform => p === "cursor" || p === "opencode",
+  );
   if (!name || !description || platforms.length === 0) {
     return { error: "rule frontmatter requires name, description, and platforms" };
   }
@@ -73,7 +75,8 @@ export const writeRule = (
   confirmed: boolean,
 ): { ok: true; path: string } | { ok: false; error: string } => {
   if (!confirmed) return { ok: false, error: "confirmed: true required" };
-  if (!RULE_NAME_RE.test(rule.name)) return { ok: false, error: `invalid rule name: ${JSON.stringify(rule.name)}` };
+  if (!RULE_NAME_RE.test(rule.name))
+    return { ok: false, error: `invalid rule name: ${JSON.stringify(rule.name)}` };
   const dir = path.join(rulesDir(), rule.name);
   mkdirSync(dir, { recursive: true });
   const file = path.join(dir, "rule.md");

package/src/core/scripts.ts

@@ -18,7 +18,7 @@ export function runScript(
   const result = spawnSync("bash", [scriptPath, ...args], {
     cwd,
     encoding: "utf8",
-    env: { ...process.env, ...(extraEnv ?? {}) },
+    env: { ...process.env, ...extraEnv },
   });
   return {
     stdout: result.stdout ?? "",
@@ -29,7 +29,12 @@ export function runScript(
   };
 }
 
-export function runScriptJson(scriptName: string, args: string[], workspaceRoot: string, extraEnv?: Record<string, string>) {
+export function runScriptJson(
+  scriptName: string,
+  args: string[],
+  workspaceRoot: string,
+  extraEnv?: Record<string, string>,
+) {
   const { stdout, stderr, exitCode } = runScript(scriptName, args, workspaceRoot, extraEnv);
   if (exitCode !== 0) {
     return { error: (stderr || stdout || "script failed").trim(), exitCode };

package/src/core/sdd.ts

@@ -57,7 +57,10 @@ export function sddContext({
   let completed_task_ids: number[] = [];
   const absProgress = path.join(cwd, progress_path);
   if (existsSync(absProgress)) {
-    progress_lines = readFileSync(absProgress, "utf8").split("\n").map((ln) => ln.trim()).filter(Boolean);
+    progress_lines = readFileSync(absProgress, "utf8")
+      .split("\n")
+      .map((ln) => ln.trim())
+      .filter(Boolean);
     const pat = /^Task\s+(\d+):\s+complete\b/i;
     completed_task_ids = progress_lines
       .map((ln) => pat.exec(ln)?.[1])
@@ -68,7 +71,11 @@ export function sddContext({
   let manifest: Record<string, unknown> = {};
   const absManifest = path.join(cwd, manifest_path);
   if (existsSync(absManifest)) {
-    try { manifest = JSON.parse(readFileSync(absManifest, "utf8")); } catch { manifest = {}; }
+    try {
+      manifest = JSON.parse(readFileSync(absManifest, "utf8"));
+    } catch {
+      manifest = {};
+    }
   }
 
   const legacy_path = path.join(cwd, ".superpowers/sdd");
@@ -83,7 +90,8 @@ export function sddContext({
     const spec_path = specMatch?.[1] ?? specMatch?.[2] ?? "";
     if (spec_path) {
       const validated = docsValidate({ spec_path, plan_path, workspace_root: cwd });
-      if (validated.ok === false) return { ok: false, errors: validated.errors, error: validated.error };
+      if (validated.ok === false)
+        return { ok: false, errors: validated.errors, error: validated.error };
     }
     const tasks = parseTasksFromPlan(planText);
     if (tasks.length > 0) {

package/src/core/templates.ts

@@ -7,12 +7,18 @@ export type TemplateName = "issue-update" | "greeting" | "headers";
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 
-export const templatePath = (name: TemplateName): string => path.join(configDir(), "templates", `${name}.md`);
+export const templatePath = (name: TemplateName): string =>
+  path.join(configDir(), "templates", `${name}.md`);
 
-export const readTemplate = (name: TemplateName): { source: "config" | "repo"; content: string } => {
+export const readTemplate = (
+  name: TemplateName,
+): { source: "config" | "repo"; content: string } => {
   const cfg = templatePath(name);
   if (existsSync(cfg)) return { source: "config", content: readFileSync(cfg, "utf8") };
-  return { source: "repo", content: readFileSync(path.join(repoRoot, "templates", `${name}.md`), "utf8") };
+  return {
+    source: "repo",
+    content: readFileSync(path.join(repoRoot, "templates", `${name}.md`), "utf8"),
+  };
 };
 
 export const writeTemplate = (
@@ -27,7 +33,11 @@ export const writeTemplate = (
   return { ok: true, path: file };
 };
 
-export const listTemplates = (): { name: TemplateName; source: "config" | "repo" | "missing"; path: string }[] =>
+export const listTemplates = (): {
+  name: TemplateName;
+  source: "config" | "repo" | "missing";
+  path: string;
+}[] =>
   (["issue-update", "greeting", "headers"] as TemplateName[]).map((name) => {
     const cfg = templatePath(name);
     const repoFile = path.join(repoRoot, "templates", `${name}.md`);