@dittowords/spec-cli 0.0.1-alpha.3 → 0.0.1-alpha.4

package/src/commands/init.ts

@@ -1,231 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-const CONFIG_NAME = "dittospec.config.json";
-const WORKSPACE_SPEC_NAME = "workspace.ditto.md";
-
-const DEFAULT_CONFIG = JSON.stringify(
-  {
-    apiBase: "https://api.dittowords.com",
-    workspaceId: "TODO: your Ditto workspace ID",
-    roots: ["."],
-  },
-  null,
-  2
-);
-
-const WORKSPACE_SPEC = `---
-workspace: true
-description: >
-  Workspace-wide content rules. Read alongside any component's index.ditto.md.
-# Managed by Ditto — do not edit below
-tags: []
-rules: []
----
-`;
-
-const CLAUDE_MD_BLOCK = `
-## Ditto Content Specs
-
-This project uses \`.ditto.md\` files to declare text surfaces on components. Rules are synced from the Ditto platform — never written by hand.
-
-### Reading specs
-
-When writing or editing text props for a component:
-
-1. Check for \`workspace.ditto.md\` at the project root for universal content rules.
-2. Check for \`index.ditto.md\` next to the component for surface-specific rules and constraints.
-3. Respect \`maxLength\` — it's a layout constraint, not a suggestion.
-4. Follow all rules in the \`rules\` key. Rules without a \`surface\` field apply to every surface; rules with \`surface\` apply only to that surface.
-
-### Creating specs
-
-When creating a new component that renders any user-facing text, scaffold a spec file:
-
-    npx ditto-spec scaffold <ComponentName> --path <dir>
-
-Then edit the generated \`index.ditto.md\` to add surfaces — one entry per piece of user-facing text the component renders:
-
-    surfaces:
-      title:
-        tags: [heading]
-        maxLength: 60
-      $children:
-        tags: [button, cta]
-        maxLength: 30
-
-- Use \`$children\` for text via children. Use dot notation for nested props (\`primaryAction.label\`). For hardcoded or internal strings, use a descriptive role name (\`headline\`, \`bodyText\`, \`submitLabel\`).
-- Check the \`tags\` key in \`workspace.ditto.md\` for tags available on the platform. Prefer reusing an existing tag over creating a new one — only a tag that exists on the platform will match rules. If no existing tag fits, create a new one following the convention of existing tags (lowercase, hyphenated).
-- **Never write \`rules\` or \`examples\` by hand.** Run \`npx ditto-spec pull\` after adding surfaces to populate rules from the platform.
-
-Parent and child specs both contribute rules. If your component passes a label to a child Button, add a surface in the parent's spec — the parent's rules (e.g., dialog-level tone) layer with the child's rules (e.g., button-level constraints). A child having its own spec does not exempt the parent from declaring surfaces for text it provides.
-
-Run \`npx ditto-spec list\` to see all existing specs.
-`;
-
-const CURSOR_RULES_BLOCK = `
-# Ditto Content Specs
-
-This project uses .ditto.md files to declare text surfaces on components. Rules are synced from the Ditto platform — never written by hand.
-
-## Reading specs
-
-When writing or editing text props for a component:
-
-1. Check for workspace.ditto.md at the project root for universal content rules.
-2. Check for index.ditto.md next to the component for surface-specific rules and constraints.
-3. Respect maxLength — it's a layout constraint, not a suggestion.
-4. Follow all rules in the rules key. Rules without a surface field apply to every surface; rules with surface apply only to that surface.
-
-## Creating specs
-
-When creating a new component that renders any user-facing text, scaffold a spec file:
-
-    npx ditto-spec scaffold <ComponentName> --path <dir>
-
-Then edit the generated index.ditto.md to add surfaces — one entry per piece of user-facing text the component renders:
-
-    surfaces:
-      title:
-        tags: [heading]
-        maxLength: 60
-      $children:
-        tags: [button, cta]
-        maxLength: 30
-
-- Use $children for text via children. Use dot notation for nested props (primaryAction.label). For hardcoded or internal strings, use a descriptive role name (headline, bodyText, submitLabel).
-- Check the tags key in workspace.ditto.md for tags available on the platform. Prefer reusing an existing tag over creating a new one — only a tag that exists on the platform will match rules. If no existing tag fits, create a new one following the convention of existing tags (lowercase, hyphenated).
-- NEVER write rules or examples by hand. Run npx ditto-spec pull after adding surfaces to populate rules from the platform.
-
-Parent and child specs both contribute rules. If your component passes a label to a child Button, add a surface in the parent's spec — the parent's rules (e.g., dialog-level tone) layer with the child's rules (e.g., button-level constraints). A child having its own spec does not exempt the parent from declaring surfaces for text it provides.
-
-Run npx ditto-spec list to see all existing specs.
-`;
-
-const AGENTS_MD_ROW =
-  "| [Ditto component specs](./packages/ditto-spec-cli/README.md) | `.ditto.md` content specs — read before writing component copy |";
-
-interface InitOptions {
-  writeAgent?: boolean;
-}
-
-type AgentEnv = "claude" | "cursor" | "none";
-
-export async function init(opts: InitOptions = {}): Promise<void> {
-  const cwd = process.cwd();
-
-  const configExists = fs.existsSync(path.join(cwd, CONFIG_NAME));
-
-  if (configExists && !opts.writeAgent) {
-    console.log(`${CONFIG_NAME} already exists. Nothing to do.`);
-    console.log("Run with --agent to add agent configuration (CLAUDE.md, .cursorrules, etc.).");
-    return;
-  }
-
-  if (!configExists) {
-    fs.writeFileSync(path.join(cwd, CONFIG_NAME), DEFAULT_CONFIG + "\n");
-    console.log(`✓ Created ${CONFIG_NAME}`);
-
-    fs.writeFileSync(path.join(cwd, WORKSPACE_SPEC_NAME), WORKSPACE_SPEC);
-    console.log(`✓ Created ${WORKSPACE_SPEC_NAME}`);
-  }
-
-  const env = detectAgentEnv(cwd);
-
-  if (opts.writeAgent) {
-    writeAgentConfig(cwd, env);
-  } else {
-    printAgentSuggestions(env);
-  }
-
-  if (!configExists) {
-    printNextSteps();
-  }
-}
-
-function detectAgentEnv(cwd: string): AgentEnv {
-  if (fs.existsSync(path.join(cwd, ".claude")) || fs.existsSync(path.join(cwd, "CLAUDE.md"))) {
-    return "claude";
-  }
-  if (fs.existsSync(path.join(cwd, ".cursor")) || fs.existsSync(path.join(cwd, ".cursorrules"))) {
-    return "cursor";
-  }
-  return "none";
-}
-
-function writeAgentConfig(cwd: string, env: AgentEnv): void {
-  if (env === "claude") {
-    const claudeMd = path.join(cwd, "CLAUDE.md");
-    if (fs.existsSync(claudeMd)) {
-      const existing = fs.readFileSync(claudeMd, "utf8");
-      if (existing.includes("## Ditto Content Specs")) {
-        console.log("  CLAUDE.md already has Ditto Content Specs section — skipped.");
-      } else {
-        fs.appendFileSync(claudeMd, CLAUDE_MD_BLOCK);
-        console.log("✓ Appended Ditto Content Specs section to CLAUDE.md");
-      }
-    } else {
-      fs.writeFileSync(claudeMd, `# CLAUDE.md${CLAUDE_MD_BLOCK}`);
-      console.log("✓ Created CLAUDE.md with Ditto Content Specs section");
-    }
-
-    const agentsMd = path.join(cwd, "AGENTS.md");
-    if (fs.existsSync(agentsMd)) {
-      const existing = fs.readFileSync(agentsMd, "utf8");
-      if (existing.includes("Ditto component specs")) {
-        console.log("  AGENTS.md already has Ditto row — skipped.");
-      } else {
-        fs.appendFileSync(agentsMd, "\n" + AGENTS_MD_ROW + "\n");
-        console.log("✓ Appended Ditto row to AGENTS.md");
-      }
-    }
-    return;
-  }
-
-  if (env === "cursor") {
-    const cursorrules = path.join(cwd, ".cursorrules");
-    if (fs.existsSync(cursorrules)) {
-      const existing = fs.readFileSync(cursorrules, "utf8");
-      if (existing.includes("Ditto Content Specs")) {
-        console.log("  .cursorrules already has Ditto section — skipped.");
-      } else {
-        fs.appendFileSync(cursorrules, CURSOR_RULES_BLOCK);
-        console.log("✓ Appended Ditto section to .cursorrules");
-      }
-    } else {
-      fs.writeFileSync(cursorrules, CURSOR_RULES_BLOCK.trimStart());
-      console.log("✓ Created .cursorrules with Ditto section");
-    }
-    return;
-  }
-
-  console.log("\nNo agent environment detected. See next steps for manual setup.");
-}
-
-function printAgentSuggestions(env: AgentEnv): void {
-  if (env === "claude") {
-    console.log("\nDetected Claude Code environment.");
-    console.log("Add this to your CLAUDE.md (or run `ditto-spec init --agent` to do it automatically):\n");
-    console.log(CLAUDE_MD_BLOCK.trim());
-    return;
-  }
-
-  if (env === "cursor") {
-    console.log("\nDetected Cursor environment.");
-    console.log("Add this to your .cursorrules (or run `ditto-spec init --agent` to do it automatically):\n");
-    console.log(CURSOR_RULES_BLOCK.trim());
-    return;
-  }
-
-  console.log("\nTo help your AI agent use ditto specs, add the agent contract from the README");
-  console.log("to your project's agent configuration file (CLAUDE.md, .cursorrules, etc.).");
-}
-
-function printNextSteps(): void {
-  console.log(`
-Next steps:
-  1. Fill in your workspaceId in ${CONFIG_NAME}
-  2. Set DITTO_API_KEY in .env or your shell
-  3. Create your first component spec (index.ditto.md next to a component)
-  4. Run \`ditto-spec pull\` to sync rules from the platform`);
-}

package/src/commands/list.ts

@@ -1,59 +0,0 @@
-import path from "path";
-import { loadConfig } from "../config";
-import { discover } from "../discover";
-import { ParsedSpec, parseSpecFile } from "../parse";
-
-interface SurfaceLike {
-  tags?: string[];
-  maxLength?: number;
-}
-
-interface SpecLike {
-  tags?: string[];
-  surfaces?: Record<string, SurfaceLike>;
-}
-
-export async function list(): Promise<void> {
-  const { config, root } = loadConfig();
-  const files = discover(root, config.roots);
-
-  if (files.length === 0) {
-    console.log("No .ditto.md files found.");
-    return;
-  }
-
-  for (const f of files) {
-    let parsed: ParsedSpec;
-    try {
-      parsed = parseSpecFile(f.abs);
-    } catch (err) {
-      console.error(`× ${path.relative(root, f.abs)}: ${err instanceof Error ? err.message : err}`);
-      continue;
-    }
-
-    if (parsed.kind === "workspace") {
-      const rules = Array.isArray(parsed.spec.rules) ? parsed.spec.rules : [];
-      console.log(`\n[workspace]  (${path.relative(root, f.abs)})`);
-      console.log(`  ${rules.length} rule${rules.length === 1 ? "" : "s"}`);
-      continue;
-    }
-
-    console.log(`\n${parsed.name}  (${path.relative(root, f.abs)})`);
-    const specLike = parsed.spec as SpecLike;
-    const componentTags = specLike.tags ?? [];
-    if (componentTags.length > 0) {
-      console.log(`  component tags: [${componentTags.join(", ")}]`);
-    }
-    const surfaces = specLike.surfaces ?? {};
-    const entries = Object.entries(surfaces);
-    if (entries.length === 0) {
-      console.log("  (no surfaces)");
-      continue;
-    }
-    for (const [key, surface] of entries) {
-      const tags = (surface.tags ?? []).join(", ");
-      const maxLen = surface.maxLength != null ? `  max ${surface.maxLength}` : "";
-      console.log(`  ${key.padEnd(28)} [${tags}]${maxLen}`);
-    }
-  }
-}

package/src/commands/pull.ts

@@ -1,152 +0,0 @@
-import path from "path";
-import { DittoApi, RuleResponse } from "../api";
-import { getApiKey, loadConfig } from "../config";
-import { discover, DiscoveredFile } from "../discover";
-import { ParsedSpec, parseSpecFile } from "../parse";
-import { rewriteManagedKeys } from "../serialize";
-
-interface SurfaceLike {
-  tags?: string[];
-}
-
-interface SpecLike {
-  tags?: string[];
-  surfaces?: Record<string, SurfaceLike>;
-}
-
-interface PullOptions {
-  dryRun?: boolean;
-}
-
-export async function pull(opts: PullOptions = {}): Promise<void> {
-  const { config, root } = loadConfig();
-  const apiKey = getApiKey();
-  const api = new DittoApi(config, apiKey);
-
-  const files = discover(root, config.roots);
-  if (files.length === 0) {
-    console.log("No .ditto.md files found.");
-    return;
-  }
-
-  console.log(`Found ${files.length} spec file${files.length === 1 ? "" : "s"}.`);
-
-  type ParsedFile = { file: DiscoveredFile; parsed: ParsedSpec };
-  const componentFiles: ParsedFile[] = [];
-  const workspaceFiles: ParsedFile[] = [];
-
-  for (const f of files) {
-    let parsed: ParsedSpec;
-    try {
-      parsed = parseSpecFile(f.abs);
-    } catch (err) {
-      console.error(`× ${f.rel}: ${err instanceof Error ? err.message : err}`);
-      continue;
-    }
-
-    if (parsed.kind === "workspace") {
-      workspaceFiles.push({ file: f, parsed });
-    } else {
-      componentFiles.push({ file: f, parsed });
-    }
-  }
-
-  if (workspaceFiles.length > 1) {
-    const paths = workspaceFiles.map((w) => path.relative(root, w.file.abs)).join(", ");
-    throw new Error(`Found multiple workspace specs (${paths}). Expected at most one.`);
-  }
-
-  const allRules = await api.getRules();
-  console.log(`Fetched ${allRules.length} rule${allRules.length === 1 ? "" : "s"} from workspace.`);
-
-  const platformTags = [...new Set(allRules.flatMap((r) => r.tags))].filter(Boolean).sort();
-
-  let written = 0;
-  let unchanged = 0;
-
-  if (workspaceFiles.length === 1) {
-    const { file, parsed } = workspaceFiles[0];
-    const universalRules = allRules.filter((r) => r.tags.length === 0).map(toRuleObj);
-
-    if (rulesMatch(parsed.spec.rules, universalRules) && tagsMatch(parsed.spec.tags, platformTags)) {
-      unchanged++;
-    } else if (opts.dryRun) {
-      console.log(
-        `~ ${path.relative(root, file.abs)} (would write ${universalRules.length} workspace rule(s), ${
-          platformTags.length
-        } tag(s))`
-      );
-    } else {
-      rewriteManagedKeys(file.abs, { tags: platformTags, rules: universalRules });
-      written++;
-      console.log(
-        `✓ ${path.relative(root, file.abs)} — ${universalRules.length} workspace rule(s), ${platformTags.length} tag(s)`
-      );
-    }
-  }
-
-  for (const { file, parsed } of componentFiles) {
-    const specLike = parsed.spec as SpecLike;
-    const componentTags = specLike.tags ?? [];
-    const surfaces = specLike.surfaces ?? {};
-
-    const componentMatches = rulesForTags(allRules, componentTags);
-    const consumed = new Set<RuleResponse>(componentMatches);
-
-    const matchedRules: Array<Record<string, unknown>> = [];
-    for (const rule of componentMatches) {
-      matchedRules.push(toRuleObj(rule));
-    }
-    for (const [surfaceKey, surface] of Object.entries(surfaces)) {
-      const matches = rulesForTags(allRules, surface.tags ?? []).filter((r) => !consumed.has(r));
-      for (const rule of matches) {
-        matchedRules.push(toSurfaceRuleObj(surfaceKey, rule));
-      }
-    }
-
-    if (rulesMatch(parsed.spec.rules, matchedRules)) {
-      unchanged++;
-      continue;
-    }
-
-    if (opts.dryRun) {
-      console.log(`~ ${path.relative(root, file.abs)} (would write ${matchedRules.length} rule(s))`);
-      continue;
-    }
-
-    rewriteManagedKeys(file.abs, { rules: matchedRules });
-    written++;
-    console.log(`✓ ${path.relative(root, file.abs)} — ${matchedRules.length} rule(s)`);
-  }
-
-  console.log(`\nDone. ${written} updated, ${unchanged} unchanged.`);
-}
-
-function rulesForTags(rules: RuleResponse[], tags: string[]): RuleResponse[] {
-  if (tags.length === 0) return [];
-  const tagSet = new Set(tags);
-  return rules.filter((r) => r.tags.length > 0 && r.tags.some((t) => tagSet.has(t)));
-}
-
-function toRuleObj(rule: RuleResponse): Record<string, unknown> {
-  const out: Record<string, unknown> = {
-    name: rule.name,
-    description: rule.description,
-  };
-  if (rule.examples.length > 0) {
-    out.examples = rule.examples.map((ex) => ({ from: ex.from, to: ex.to }));
-  }
-  return out;
-}
-
-function toSurfaceRuleObj(surface: string, rule: RuleResponse): Record<string, unknown> {
-  return { surface, ...toRuleObj(rule) };
-}
-
-function rulesMatch(existing: unknown, incoming: unknown): boolean {
-  return JSON.stringify(existing ?? []) === JSON.stringify(incoming);
-}
-
-function tagsMatch(existing: unknown, incoming: string[]): boolean {
-  return JSON.stringify(existing ?? []) === JSON.stringify(incoming);
-}

package/src/commands/scaffold.ts

@@ -1,40 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-const SPEC_FILENAME = "index.ditto.md";
-
-interface ScaffoldOptions {
-  componentName: string;
-  targetDir: string;
-}
-
-export async function scaffold(opts: ScaffoldOptions): Promise<void> {
-  const dest = path.join(opts.targetDir, SPEC_FILENAME);
-
-  if (fs.existsSync(dest)) {
-    console.log(`${SPEC_FILENAME} already exists at ${opts.targetDir}. Nothing to do.`);
-    return;
-  }
-
-  const content = `---
-component: ${opts.componentName}
-description: >
-  TODO: describe this component.
-tags: []
-surfaces: {}
-# Managed by Ditto — do not edit below
-rules: []
-examples: []
----
-`;
-
-  fs.mkdirSync(opts.targetDir, { recursive: true });
-  fs.writeFileSync(dest, content);
-  console.log(`✓ Created ${path.relative(process.cwd(), dest)}`);
-
-  console.log(`
-Next steps:
-  1. Add a surface key for each piece of user-facing text the component renders
-  2. Tag each surface with content categories (heading, body, button, cta, etc.)
-  3. Run \`ditto-spec pull\` to populate rules from the platform`);
-}

package/src/config.ts

@@ -1,55 +0,0 @@
-import dotenv from "dotenv";
-import fs from "fs";
-import path from "path";
-
-export interface Config {
-  apiBase: string;
-  workspaceId: string;
-  roots?: string[];
-}
-
-const DEFAULT_CONFIG_NAME = "dittospec.config.json";
-
-export function loadConfig(cwd: string = process.cwd()): { config: Config; root: string } {
-  let dir = path.resolve(cwd);
-  while (true) {
-    const candidate = path.join(dir, DEFAULT_CONFIG_NAME);
-    if (fs.existsSync(candidate)) {
-      const raw = fs.readFileSync(candidate, "utf8");
-      const parsed = JSON.parse(raw);
-      validate(parsed, candidate);
-      return { config: parsed as Config, root: dir };
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  throw new Error(`No ${DEFAULT_CONFIG_NAME} found from ${cwd} up to filesystem root.`);
-}
-
-function validate(c: unknown, source: string): asserts c is Config {
-  if (!c || typeof c !== "object") throw new Error(`${source}: must be a JSON object.`);
-  const obj = c as Record<string, unknown>;
-  if (typeof obj.apiBase !== "string") throw new Error(`${source}: missing string "apiBase".`);
-  if (typeof obj.workspaceId !== "string") throw new Error(`${source}: missing string "workspaceId".`);
-  if (obj.roots !== undefined && !Array.isArray(obj.roots)) {
-    throw new Error(`${source}: "roots" must be an array of strings if present.`);
-  }
-}
-
-export function getApiKey(): string {
-  try {
-    const { root } = loadConfig();
-    dotenv.config({ path: path.join(root, ".env") });
-  } catch {
-    // No config yet — let getApiKey still work for direct env exports.
-  }
-
-  const key = process.env.DITTO_API_KEY;
-  if (!key) {
-    throw new Error(
-      "DITTO_API_KEY is not set. Add it to .env at the repo root, or `export DITTO_API_KEY=...` in your shell."
-    );
-  }
-  return key;
-}

package/src/discover.ts

@@ -1,23 +0,0 @@
-import { globSync } from "glob";
-import path from "path";
-
-const SPEC_GLOB = "**/*.ditto.md";
-
-const IGNORE = ["**/node_modules/**", "**/dist*/**", "**/.git/**", "**/.next/**", "**/coverage/**"];
-
-export interface DiscoveredFile {
-  abs: string;
-  rel: string;
-}
-
-export function discover(repoRoot: string, roots: string[] = ["."]): DiscoveredFile[] {
-  const patterns = roots.map((r) => path.posix.join(r, SPEC_GLOB));
-
-  const results = globSync(patterns, {
-    cwd: repoRoot,
-    ignore: IGNORE,
-    absolute: true,
-  });
-
-  return results.map((abs) => ({ abs, rel: path.relative(repoRoot, abs) })).sort((a, b) => a.rel.localeCompare(b.rel));
-}

package/src/parse.ts

@@ -1,45 +0,0 @@
-import fs from "fs";
-import yaml from "js-yaml";
-
-export interface ParsedSpec {
-  kind: "component" | "workspace";
-  name?: string;
-  spec: Record<string, unknown>;
-  filePath: string;
-}
-
-export class ParseError extends Error {
-  constructor(public filePath: string, public reason: string) {
-    super(`${filePath}: ${reason}`);
-  }
-}
-
-export function parseSpecFile(filePath: string): ParsedSpec {
-  const source = fs.readFileSync(filePath, "utf8");
-  const frontmatter = extractFrontmatter(source, filePath);
-  const raw = yaml.load(frontmatter);
-
-  if (!raw || typeof raw !== "object") {
-    throw new ParseError(filePath, "frontmatter must be a YAML object");
-  }
-
-  const spec = raw as Record<string, unknown>;
-
-  if (spec.workspace === true) {
-    return { kind: "workspace", spec, filePath };
-  }
-
-  if (typeof spec.component !== "string" || !spec.component) {
-    throw new ParseError(filePath, "missing required 'component' key (string)");
-  }
-
-  return { kind: "component", name: spec.component, spec, filePath };
-}
-
-function extractFrontmatter(source: string, filePath: string): string {
-  const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) {
-    throw new ParseError(filePath, "no YAML frontmatter found (expected --- delimiters)");
-  }
-  return match[1];
-}

package/src/serialize.ts

@@ -1,45 +0,0 @@
-import fs from "fs";
-import yaml from "js-yaml";
-
-const MANAGED_COMMENT = "# Managed by Ditto — do not edit below";
-
-export function rewriteManagedKeys(filePath: string, updates: { tags?: string[]; rules?: unknown[] }): void {
-  const source = fs.readFileSync(filePath, "utf8");
-  const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) throw new Error(`${filePath}: no YAML frontmatter found`);
-
-  const spec = yaml.load(match[1]) as Record<string, unknown>;
-
-  if (updates.tags !== undefined) {
-    const savedRules = spec.rules;
-    delete spec.rules;
-    spec.tags = updates.tags;
-    spec.rules = savedRules;
-  }
-  if (updates.rules !== undefined) spec.rules = updates.rules;
-
-  let dumped = yaml
-    .dump(spec, {
-      lineWidth: -1,
-      noRefs: true,
-      sortKeys: false,
-      quotingType: '"',
-    })
-    .trimEnd();
-
-  dumped = insertManagedComment(dumped, updates.tags !== undefined);
-
-  const afterFrontmatter = source.slice(match[0].length);
-  fs.writeFileSync(filePath, `---\n${dumped}\n---${afterFrontmatter}`);
-}
-
-function insertManagedComment(dumped: string, managedTagsPresent: boolean): string {
-  const targetKey = managedTagsPresent ? "tags" : "rules";
-  const idx = dumped.search(new RegExp(`^${targetKey}:`, "m"));
-  if (idx === -1) return dumped;
-
-  const before = dumped.slice(0, idx);
-  if (before.includes(MANAGED_COMMENT)) return dumped;
-
-  return before + MANAGED_COMMENT + "\n" + dumped.slice(idx);
-}