@dogsbay/commands 0.2.0-beta.101

package/dist/commands/refactor-structure.js

@@ -0,0 +1,314 @@
+/**
+ * Structural refactor commands: split-topic, merge-topics.
+ *
+ * Both operate line-wise with the shared fence grammar (a `## heading`
+ * inside a code example is never structure), then reindex and repair
+ * inbound references so links keep landing after the surgery. What
+ * cannot be repaired mechanically is issued, never silently dropped.
+ */
+import { z } from "zod";
+import { fenceOpenBefore, slugifyHeadingText, transformProseLines } from "@dogsbay/format-dogsbay-md";
+import { dirname } from "@dogsbay/format-topicmap";
+import { normalizeStoragePath } from "../storage.js";
+import { relativeHref, replaceLinkHrefs, replaceIncludePaths, rewriteInboundRefs, splitFrontmatter, } from "../edits.js";
+import { defineCommand } from "../engine.js";
+import { missIssues } from "./refactor-files.js";
+import { contentHash } from "./content.js";
+const fail = (code, message, file) => ({
+    data: { applied: false },
+    issues: [{ severity: "error", code, message, ...(file ? { file } : {}) }],
+    summary: message,
+});
+/** `## Title {#id}` → { title, id }. */
+const parseH2 = (line) => {
+    const match = line.match(/^##\s+(.*?)\s*(?:\{#([^}]+)\})?\s*$/);
+    return { title: match?.[1] ?? line.replace(/^##\s*/, ""), ...(match?.[2] ? { id: match[2] } : {}) };
+};
+export const splitTopicCommand = defineCommand({
+    name: "split-topic",
+    writes: "content",
+    description: "Split a document at its level-2 headings into sibling topics plus a topic map; inbound anchor links follow their sections",
+    input: z
+        .object({
+        file: z.string().min(1).describe("Workspace-relative .md path to split"),
+        expect: z.string().optional().describe("Divergence gate: the file's `fileHash` from topic-read"),
+    })
+        .strict(),
+    positionals: ["file"],
+    async run(ctx, input) {
+        const file = normalizeStoragePath(input.file);
+        const { storage } = ctx.workspace;
+        if (!(await storage.exists(file)))
+            return fail("split-source-missing", `${file} does not exist`);
+        const index = await ctx.workspace.index();
+        const doc = index.docs.get(file);
+        if (!doc)
+            return fail("split-not-a-doc", `${file} is not an indexed markdown document`);
+        const content = await storage.read(file);
+        if (input.expect !== undefined && input.expect !== contentHash(content)) {
+            return fail("stale-expect", `${file} changed since it was read; nothing written. Re-read it with topic-read.`, file);
+        }
+        // Frontmatter is metadata: `## ` lines inside it (YAML comments,
+        // block scalars) are never section boundaries, and the block stays
+        // with the preamble page
+        const [frontmatterBlock, body] = splitFrontmatter(content);
+        const lines = body.split("\n");
+        const openBefore = fenceOpenBefore(body);
+        const h2Lines = lines
+            .map((line, i) => ({ line, i }))
+            .filter(({ line, i }) => /^##\s/.test(line) && !openBefore[i])
+            .map(({ i }) => i);
+        if (h2Lines.length === 0) {
+            return fail("split-no-sections", `${file} has no level-2 headings to split at`, file);
+        }
+        const dir = dirname(file);
+        const stem = file.split("/").pop().replace(/\.md$/, "");
+        const mapPath = dir ? `${dir}/${stem}.topicmap.yml` : `${stem}.topicmap.yml`;
+        if (await storage.exists(mapPath)) {
+            return fail("split-map-exists", `${mapPath} already exists`, mapPath);
+        }
+        // Section boundaries → new sibling files
+        const taken = new Set(await storage.list());
+        const sections = [];
+        for (let s = 0; s < h2Lines.length; s++) {
+            const start = h2Lines[s];
+            const end = s + 1 < h2Lines.length ? h2Lines[s + 1] : lines.length;
+            const { title } = parseH2(lines[start]);
+            const base = `${stem}-${slugifyHeadingText(title) || `section-${s + 1}`}`;
+            let name = dir ? `${dir}/${base}.md` : `${base}.md`;
+            let suffix = 2;
+            while (taken.has(name)) {
+                name = dir ? `${dir}/${base}-${suffix}.md` : `${base}-${suffix}.md`;
+                suffix++;
+            }
+            taken.add(name);
+            const body = lines.slice(start, end).join("\n").replace(/\s+$/, "");
+            sections.push({
+                path: name,
+                title,
+                body: `---\ntitle: ${JSON.stringify(title)}\n---\n\n${body}\n`,
+            });
+        }
+        // Write pieces, shrink the original to its preamble, emit the map
+        for (const section of sections)
+            await storage.write(section.path, section.body);
+        const preamble = lines.slice(0, h2Lines[0]).join("\n").replace(/\s+$/, "");
+        await storage.write(file, `${frontmatterBlock}${preamble}\n`);
+        const mapEntries = [
+            `  - navtitle: ${JSON.stringify(doc.title ?? stem)}`,
+            `    href: ${stem}.md`,
+            ...sections.flatMap((section) => [
+                `  - navtitle: ${JSON.stringify(section.title)}`,
+                `    href: ${section.path.split("/").pop()}`,
+            ]),
+        ];
+        await storage.write(mapPath, `topics:\n${mapEntries.join("\n")}\n`);
+        // Anchor repair: fragments that moved into a section file get their
+        // inbound links re-pointed there (needs the POST-split index)
+        const newIndex = await ctx.workspace.reindex();
+        const issues = [];
+        const { changed, misses } = await rewriteInboundRefs(ctx.workspace, newIndex, file, (ref) => {
+            const fragment = ref.fragment;
+            if (!fragment)
+                return null; // whole-file links still land (preamble page)
+            if (newIndex.docs.get(file)?.anchors.includes(fragment))
+                return null;
+            const home = sections.find((section) => newIndex.docs.get(section.path)?.anchors.includes(fragment));
+            if (!home) {
+                issues.push({
+                    severity: "warning",
+                    code: "split-anchor-lost",
+                    message: `link "${ref.raw}" targets #${fragment}, which no piece of the split carries`,
+                    file: ref.from,
+                });
+                return null;
+            }
+            return `${relativeHref(dirname(ref.from), home.path)}#${fragment}`;
+        });
+        issues.push(...missIssues(misses));
+        ctx.workspace.invalidate();
+        return {
+            data: {
+                applied: true,
+                file,
+                map: mapPath,
+                sections: sections.map(({ path, title }) => ({ path, title })),
+                rewrittenFiles: changed,
+            },
+            issues,
+            summary: `${file} split into ${sections.length} section file(s) + ${mapPath}`,
+        };
+    },
+});
+export const mergeTopicsCommand = defineCommand({
+    name: "merge-topics",
+    writes: "content",
+    description: "Merge source documents into a target as level-2 sections (headings shifted), deleting the sources and re-pointing inbound references",
+    input: z
+        .object({
+        into: z.string().min(1).describe("Workspace-relative .md target"),
+        sources: z
+            .array(z.string().min(1))
+            .min(1)
+            .describe("Source .md file merged into the target (repeatable)"),
+        expect: z.string().optional().describe("Divergence gate: the TARGET's `fileHash` from topic-read"),
+    })
+        .strict(),
+    positionals: ["into"],
+    async run(ctx, input) {
+        const into = normalizeStoragePath(input.into);
+        const sources = input.sources.map(normalizeStoragePath);
+        const { storage } = ctx.workspace;
+        if (!(await storage.exists(into)))
+            return fail("merge-target-missing", `${into} does not exist`);
+        if (sources.includes(into))
+            return fail("merge-into-self", "a source cannot be the merge target");
+        if (new Set(sources).size !== sources.length)
+            return fail("merge-duplicate-source", "duplicate source paths");
+        for (const source of sources) {
+            if (!(await storage.exists(source)))
+                return fail("merge-source-missing", `${source} does not exist`);
+        }
+        const index = await ctx.workspace.index();
+        const intoDir = dirname(into);
+        const issues = [];
+        // Section anchors are derivable up front — links BETWEEN sources
+        // need them before their sections are appended. Uniquified against
+        // the target's existing anchors AND each other: two sources named
+        // a/intro.md and b/intro.md must not both become {#intro}, or
+        // re-pointed links land on the wrong section.
+        const sectionAnchors = new Map();
+        const takenAnchors = new Set(index.docs.get(into)?.anchors ?? []);
+        for (const source of sources) {
+            const stem = source.split("/").pop().replace(/\.md$/, "");
+            const base = slugifyHeadingText(stem) || "section";
+            let anchor = base;
+            let suffix = 2;
+            while (takenAnchors.has(anchor)) {
+                anchor = `${base}-${suffix}`;
+                suffix++;
+            }
+            takenAnchors.add(anchor);
+            sectionAnchors.set(source, anchor);
+        }
+        const intoContent = await storage.read(into);
+        if (input.expect !== undefined && input.expect !== contentHash(intoContent)) {
+            return fail("stale-expect", `${into} changed since it was read; nothing written. Re-read it with topic-read.`, into);
+        }
+        let merged = intoContent.replace(/\s+$/, "");
+        for (const source of sources) {
+            const doc = index.docs.get(source);
+            const raw = await storage.read(source);
+            const [, body] = splitFrontmatter(raw);
+            const stem = source.split("/").pop().replace(/\.md$/, "");
+            const title = doc?.title ?? doc?.headings[0]?.text ?? stem;
+            const anchor = sectionAnchors.get(source);
+            // Headings drop one level so the source becomes a section of the
+            // target; H6 has nowhere to go and stays put (issued below)
+            let h6 = 0;
+            let shifted = transformProseLines(body, (line) => {
+                if (/^######\s/.test(line)) {
+                    h6++;
+                    return line;
+                }
+                return line.replace(/^(#{1,5})(\s)/, "$1#$2");
+            });
+            if (h6 > 0) {
+                issues.push({
+                    severity: "warning",
+                    code: "merge-heading-depth",
+                    message: `${source}: ${h6} level-6 heading(s) could not shift deeper`,
+                    file: source,
+                });
+            }
+            // Rewrite the section body's own references: links to co-merged
+            // sources become same-document #anchor links (regardless of
+            // directories), and everything else is rebased from the target's
+            // directory when the source lived elsewhere
+            if (doc) {
+                const dirChanged = dirname(source) !== intoDir;
+                const linkPairs = new Map();
+                for (const link of doc.links) {
+                    if (!link.target || link.href.startsWith("#"))
+                        continue;
+                    if (sources.includes(link.target) || link.target === source) {
+                        const fragment = link.fragment ?? sectionAnchors.get(link.target === source ? source : link.target);
+                        linkPairs.set(link.href, `#${fragment}`);
+                    }
+                    else if (dirChanged) {
+                        const fragment = link.fragment ? `#${link.fragment}` : "";
+                        linkPairs.set(link.href, relativeHref(intoDir, link.target) + fragment);
+                    }
+                }
+                shifted = replaceLinkHrefs(shifted, linkPairs);
+                if (dirChanged) {
+                    const includePairs = new Map();
+                    for (const include of doc.includes) {
+                        includePairs.set(include.raw, relativeHref(intoDir, include.target));
+                    }
+                    shifted = replaceIncludePaths(shifted, includePairs);
+                }
+            }
+            merged += `\n\n## ${title} {#${anchor}}\n\n${shifted.trim()}\n`;
+        }
+        await storage.write(into, `${merged.replace(/\s+$/, "")}\n`);
+        for (const source of sources)
+            await storage.delete(source);
+        // Re-point inbound references using the merged target's real anchors
+        const newIndex = await ctx.workspace.reindex();
+        const mergedAnchors = newIndex.docs.get(into)?.anchors ?? [];
+        const rewritten = [];
+        for (const source of sources) {
+            const anchor = sectionAnchors.get(source);
+            const { changed, misses } = await rewriteInboundRefs(ctx.workspace, index, source, (ref) => {
+                if (ref.from === into || sources.includes(ref.from))
+                    return null; // gone or self
+                const base = relativeHref(dirname(ref.from), into);
+                if (ref.kind === "topicmap") {
+                    issues.push({
+                        severity: "warning",
+                        code: "merge-map-entry",
+                        message: `topic-map entry "${ref.raw}" now points at ${into} — review for duplicate entries`,
+                        file: ref.from,
+                    });
+                    return base;
+                }
+                if (ref.kind === "include") {
+                    issues.push({
+                        severity: "warning",
+                        code: "merge-include-widened",
+                        message: `include "${ref.raw}" now splices the whole merged ${into}`,
+                        file: ref.from,
+                    });
+                    return base;
+                }
+                if (ref.fragment && mergedAnchors.includes(ref.fragment)) {
+                    return `${base}#${ref.fragment}`;
+                }
+                if (ref.fragment) {
+                    issues.push({
+                        severity: "warning",
+                        code: "merge-anchor-lost",
+                        message: `link "${ref.raw}": #${ref.fragment} did not survive the merge — re-pointed at the section heading`,
+                        file: ref.from,
+                    });
+                }
+                return `${base}#${anchor}`;
+            });
+            issues.push(...missIssues(misses));
+            rewritten.push(...changed);
+        }
+        ctx.workspace.invalidate();
+        return {
+            data: {
+                applied: true,
+                into,
+                merged: sources.map((source) => ({ source, anchor: sectionAnchors.get(source) })),
+                rewrittenFiles: [...new Set(rewritten)],
+            },
+            issues,
+            summary: `${sources.length} topic(s) merged into ${into}`,
+        };
+    },
+});
+//# sourceMappingURL=refactor-structure.js.map

package/dist/commands/refactor-structure.js.map

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

package/dist/commands/reindex.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `reindex` — rebuild the workspace indexes and report what's in them.
+ *
+ * One-shot CLI runs build indexes lazily anyway; this command exists
+ * for long-lived hosts (JSON-RPC server, MCP, watch mode) and as the
+ * quick "what does the engine see" probe.
+ */
+import { z } from "zod";
+export declare const reindexCommand: import("../engine.js").CommandDef<z.ZodObject<{}, z.core.$strict>>;
+//# sourceMappingURL=reindex.d.ts.map

package/dist/commands/reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../src/commands/reindex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc,oEAYzB,CAAC"}

package/dist/commands/reindex.js

@@ -0,0 +1,23 @@
+/**
+ * `reindex` — rebuild the workspace indexes and report what's in them.
+ *
+ * One-shot CLI runs build indexes lazily anyway; this command exists
+ * for long-lived hosts (JSON-RPC server, MCP, watch mode) and as the
+ * quick "what does the engine see" probe.
+ */
+import { z } from "zod";
+import { defineCommand } from "../engine.js";
+export const reindexCommand = defineCommand({
+    name: "reindex",
+    writes: "none",
+    description: "Rebuild the workspace indexes and print their statistics",
+    input: z.object({}).strict(),
+    async run(ctx) {
+        const index = await ctx.workspace.reindex();
+        return {
+            data: { stats: index.stats },
+            summary: `${index.stats.docs} doc(s), ${index.stats.maps} map(s), ${index.stats.keys} key(s), ${index.stats.links} link(s), ${index.stats.includes} include(s)`,
+        };
+    },
+});
+//# sourceMappingURL=reindex.js.map

package/dist/commands/reindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.js","sourceRoot":"","sources":["../../src/commands/reindex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,0DAA0D;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,KAAK,CAAC,GAAG,CAAC,GAAG;QACX,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;YAC5B,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,KAAK,CAAC,KAAK,aAAa,KAAK,CAAC,KAAK,CAAC,QAAQ,aAAa;SAChK,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/topicmap-edit.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Structure verbs over topic maps (`*.topicmap.yml`) — `map-list`,
+ * `map-add-ref`, `map-move-ref`, `map-remove-ref`, `map-set-props`
+ * (plans/agent-broker.md Phase 3; plans/topicmap-editor.md Phase 2/4).
+ *
+ * Every edit goes through `applyMapEdit` in `@dogsbay/format-topicmap`
+ * (`edit-source.ts`): the model transforms (`edit.ts`) validate and the
+ * change is replayed on the YAML document, so comments, unknown keys and
+ * the author's formatting survive (a minimal diff, not a canonical
+ * rewrite). SHARED with the IDE's Structure panel: a dangling href, a self-include, moving an entry into
+ * its own subtree, or an unresolvable pointer is refused with an issue,
+ * not applied — identically for the agent and for a human. This module is
+ * the I/O shell: load, existence predicate, write, issue shaping.
+ * Entries are addressed by POINTER — a dotted index path like `0.2.1`
+ * (`""` is the root) — or, where unambiguous, by `href`.
+ */
+import { z } from "zod";
+export declare const mapListCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    map: z.ZodString;
+}, z.core.$strict>>;
+export declare const mapAddRefCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    map: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+    navtitle: z.ZodOptional<z.ZodString>;
+    parent: z.ZodDefault<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<{
+        topicmap: "topicmap";
+        md: "md";
+    }>>;
+    toc: z.ZodOptional<z.ZodBoolean>;
+    singlePage: z.ZodOptional<z.ZodEnum<{
+        yes: "yes";
+        children: "children";
+        no: "no";
+    }>>;
+}, z.core.$strict>>;
+export declare const mapMoveRefCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    map: z.ZodString;
+    from: z.ZodString;
+    toParent: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>>;
+export declare const mapRemoveRefCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    map: z.ZodString;
+    at: z.ZodString;
+    keepChildren: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>>;
+export declare const mapSetPropsCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    map: z.ZodString;
+    at: z.ZodString;
+    navtitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    format: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        topicmap: "topicmap";
+        md: "md";
+    }>>>;
+    toc: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    singlePage: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        yes: "yes";
+        children: "children";
+        no: "no";
+    }>>>;
+}, z.core.$strict>>;
+//# sourceMappingURL=topicmap-edit.d.ts.map

package/dist/commands/topicmap-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topicmap-edit.d.ts","sourceRoot":"","sources":["../../src/commands/topicmap-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8DxB,eAAO,MAAM,cAAc;;mBAYzB,CAAC;AAIH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;mBA8B3B,CAAC;AAIH,eAAO,MAAM,iBAAiB;;;;;mBAsB5B,CAAC;AAIH,eAAO,MAAM,mBAAmB;;;;mBA6B9B,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;mBA0B7B,CAAC"}

package/dist/commands/topicmap-edit.js

@@ -0,0 +1,194 @@
+/**
+ * Structure verbs over topic maps (`*.topicmap.yml`) — `map-list`,
+ * `map-add-ref`, `map-move-ref`, `map-remove-ref`, `map-set-props`
+ * (plans/agent-broker.md Phase 3; plans/topicmap-editor.md Phase 2/4).
+ *
+ * Every edit goes through `applyMapEdit` in `@dogsbay/format-topicmap`
+ * (`edit-source.ts`): the model transforms (`edit.ts`) validate and the
+ * change is replayed on the YAML document, so comments, unknown keys and
+ * the author's formatting survive (a minimal diff, not a canonical
+ * rewrite). SHARED with the IDE's Structure panel: a dangling href, a self-include, moving an entry into
+ * its own subtree, or an unresolvable pointer is refused with an issue,
+ * not applied — identically for the agent and for a human. This module is
+ * the I/O shell: load, existence predicate, write, issue shaping.
+ * Entries are addressed by POINTER — a dotted index path like `0.2.1`
+ * (`""` is the root) — or, where unambiguous, by `href`.
+ */
+import { z } from "zod";
+import { parseTopicMap, applyMapEdit, flattenTopicMap, hrefTarget, } from "@dogsbay/format-topicmap";
+import { normalizeStoragePath } from "../storage.js";
+import { defineCommand } from "../engine.js";
+const fail = (code, message, file, extra = {}) => ({
+    data: { applied: false, ...extra },
+    issues: [{ severity: "error", code, message, ...(file ? { file } : {}) }],
+    summary: message,
+});
+const refused = (r, file) => fail(r.code, r.message, file, r.extra ?? {});
+const isOutput = (x) => typeof x === "object" && x !== null && "data" in x;
+const loadMap = async (ctx, rawFile) => {
+    const file = normalizeStoragePath(rawFile);
+    const { storage } = ctx.workspace;
+    if (!(await storage.exists(file)))
+        return fail("map-missing", `${file} does not exist`, file);
+    const source = await storage.read(file);
+    const { map, errors } = parseTopicMap(source, file);
+    if (!map) {
+        return {
+            data: { applied: false },
+            issues: errors.map((e) => ({ severity: "error", code: e.code, message: e.message, file })),
+            summary: `${file}: ${errors[0]?.message ?? "invalid topic map"}`,
+        };
+    }
+    const existsFor = async (hrefs) => {
+        const known = new Map();
+        for (const href of hrefs) {
+            const target = hrefTarget(file, href);
+            if (target !== undefined && !known.has(target))
+                known.set(target, await storage.exists(target));
+        }
+        return (p) => known.get(p) ?? false;
+    };
+    return { file, map, source, existsFor };
+};
+const write = async (ctx, file, source) => {
+    await ctx.workspace.storage.write(file, source);
+    ctx.workspace.invalidate();
+};
+// ─── map-list ───────────────────────────────────────────────────────────────
+export const mapListCommand = defineCommand({
+    name: "map-list",
+    writes: "none",
+    description: "List a topic map's entries with their pointers (dotted index paths), depth, href, format and flags",
+    input: z.object({ map: z.string().min(1).describe("Workspace-relative *.topicmap.yml") }).strict(),
+    positionals: ["map"],
+    async run(ctx, input) {
+        const loaded = await loadMap(ctx, input.map);
+        if (isOutput(loaded))
+            return loaded;
+        const entries = flattenTopicMap(loaded.map);
+        return { data: { map: loaded.file, title: loaded.map.title, entries }, summary: `${loaded.file}: ${entries.length} entr${entries.length === 1 ? "y" : "ies"}` };
+    },
+});
+// ─── map-add-ref ────────────────────────────────────────────────────────────
+export const mapAddRefCommand = defineCommand({
+    name: "map-add-ref",
+    writes: "structure",
+    description: "Add a topicref to a topic map under a parent (pointer or href; root by default) at an index (end by default). Refuses a dangling local href or a self-include",
+    input: z
+        .object({
+        map: z.string().min(1).describe("Workspace-relative *.topicmap.yml"),
+        href: z.string().min(1).optional().describe("Target path relative to the map (or / for the root map's dir), or an external URL; optional for a title-only grouping entry"),
+        navtitle: z.string().min(1).optional().describe("Navigation label (optional when the target provides a title; required without href)"),
+        parent: z.string().default("").describe('Parent pointer ("0.2") or href; "" = root'),
+        index: z.number().int().min(0).optional().describe("Position among siblings (default: append)"),
+        format: z.enum(["topicmap", "md"]).optional(),
+        toc: z.boolean().optional(),
+        singlePage: z.enum(["yes", "no", "children"]).optional(),
+    })
+        .strict(),
+    // href is optional (title-only grouping entries), so it is not positional
+    positionals: ["map"],
+    async run(ctx, input) {
+        const loaded = await loadMap(ctx, input.map);
+        if (isOutput(loaded))
+            return loaded;
+        const { file, source } = loaded;
+        const exists = await loaded.existsFor(input.href ? [input.href] : []);
+        const r = applyMapEdit(source, file, { kind: "add", ...input }, exists);
+        if (!r.ok)
+            return refused(r, file);
+        await write(ctx, file, r.source);
+        const issues = [];
+        return { data: { applied: true, map: file, pointer: r.pointer, entry: r.entry, target: r.target }, issues, summary: `${file}: added ${input.href ?? input.navtitle} at ${r.pointer || "root"}` };
+    },
+});
+// ─── map-move-ref ───────────────────────────────────────────────────────────
+export const mapMoveRefCommand = defineCommand({
+    name: "map-move-ref",
+    writes: "structure",
+    description: "Move an entry (with its subtree) to a new parent and/or index. Refuses moving into its own subtree",
+    input: z
+        .object({
+        map: z.string().min(1).describe("Workspace-relative *.topicmap.yml"),
+        from: z.string().min(1).describe("Pointer or href of the entry to move"),
+        toParent: z.string().optional().describe('New parent pointer/href ("" = root); default: same parent'),
+        index: z.number().int().min(0).optional().describe("Position among the new siblings (default: append)"),
+    })
+        .strict(),
+    positionals: ["map", "from"],
+    async run(ctx, input) {
+        const loaded = await loadMap(ctx, input.map);
+        if (isOutput(loaded))
+            return loaded;
+        const { file, source } = loaded;
+        const r = applyMapEdit(source, file, { kind: "move", ...input });
+        if (!r.ok)
+            return refused(r, file);
+        await write(ctx, file, r.source);
+        return { data: { applied: true, map: file, from: r.from, to: r.pointer, entry: r.entry }, summary: `${file}: moved ${r.entry.href ?? r.entry.navtitle ?? r.from} → ${r.pointer}` };
+    },
+});
+// ─── map-remove-ref ─────────────────────────────────────────────────────────
+export const mapRemoveRefCommand = defineCommand({
+    name: "map-remove-ref",
+    writes: "structure",
+    description: "Remove an entry. Its children go with it unless keepChildren=true (they are then hoisted into its place)",
+    input: z
+        .object({
+        map: z.string().min(1).describe("Workspace-relative *.topicmap.yml"),
+        at: z.string().min(1).describe("Pointer or href of the entry"),
+        keepChildren: z.boolean().default(false).describe("Hoist the entry's children into its position instead of removing them"),
+    })
+        .strict(),
+    positionals: ["map", "at"],
+    async run(ctx, input) {
+        const loaded = await loadMap(ctx, input.map);
+        if (isOutput(loaded))
+            return loaded;
+        const { file, source } = loaded;
+        const r = applyMapEdit(source, file, { kind: "remove", ...input });
+        if (!r.ok)
+            return refused(r, file);
+        await write(ctx, file, r.source);
+        const issues = [];
+        if (r.childrenRemoved) {
+            issues.push({ severity: "warning", code: "map-children-removed", message: `${r.childrenRemoved} child entr${r.childrenRemoved === 1 ? "y" : "ies"} removed with ${input.at}`, file });
+        }
+        return {
+            data: { applied: true, map: file, pointer: r.pointer, entry: r.entry, childrenRemoved: r.childrenRemoved, childrenHoisted: r.childrenHoisted },
+            issues,
+            summary: `${file}: removed ${r.entry.href ?? r.entry.navtitle ?? input.at}${r.childrenHoisted ? ` (hoisted ${r.childrenHoisted} children)` : ""}`,
+        };
+    },
+});
+// ─── map-set-props ──────────────────────────────────────────────────────────
+export const mapSetPropsCommand = defineCommand({
+    name: "map-set-props",
+    writes: "structure",
+    description: "Set (or with null, unset) an entry's navtitle, href, format, toc, singlePage. A new local href must resolve",
+    input: z
+        .object({
+        map: z.string().min(1).describe("Workspace-relative *.topicmap.yml"),
+        at: z.string().min(1).describe("Pointer or href of the entry"),
+        navtitle: z.string().min(1).nullable().optional(),
+        href: z.string().min(1).nullable().optional(),
+        format: z.enum(["topicmap", "md"]).nullable().optional(),
+        toc: z.boolean().nullable().optional(),
+        singlePage: z.enum(["yes", "no", "children"]).nullable().optional(),
+    })
+        .strict(),
+    positionals: ["map", "at"],
+    async run(ctx, input) {
+        const loaded = await loadMap(ctx, input.map);
+        if (isOutput(loaded))
+            return loaded;
+        const { file, source } = loaded;
+        const exists = await loaded.existsFor(typeof input.href === "string" ? [input.href] : []);
+        const r = applyMapEdit(source, file, { kind: "set", ...input }, exists);
+        if (!r.ok)
+            return refused(r, file);
+        await write(ctx, file, r.source);
+        return { data: { applied: true, map: file, pointer: r.pointer, changed: r.changed, entry: r.entry }, summary: `${file}: set ${(r.changed ?? []).join(", ")} on ${r.pointer}` };
+    },
+});
+//# sourceMappingURL=topicmap-edit.js.map