domain-knowledge-kit 0.2.10 → 0.2.11

package/dist/features/refactor/commands/move.d.ts

@@ -0,0 +1,14 @@
+/**
+ * move command — relocate a domain item from one bounded context to another.
+ *
+ * Unlike 'rename', this command moves an item's YAML file to a different
+ * context directory and rewrites all references (flows, ADR domain_refs,
+ * same-context and cross-context domain items) to use the new scoped ID.
+ *
+ * Usage:
+ *   dkk move <id> <new-context>              # keeps same item name
+ *   dkk move <id> <new-context.NewName>      # renames as well
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerMove(program: Cmd): void;
+//# sourceMappingURL=move.d.ts.map

package/dist/features/refactor/commands/move.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../../../src/features/refactor/commands/move.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAmBhD,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAsN/C"}

package/dist/features/refactor/commands/move.js

@@ -0,0 +1,166 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { loadDomainModel } from "../../../shared/loader.js";
+import { contextsDir } from "../../../shared/paths.js";
+import { DomainGraph } from "../../../shared/graph.js";
+import { parseYaml, stringifyYaml } from "../../../shared/yaml.js";
+import { classifyId, KIND_TO_DIR, rewriteFile, updateAdrFrontmatter, updateFlowStepsForItem, renameDomainItemRef, allAdrFiles, allDomainFiles, printDiff, } from "../refactor-helpers.js";
+export function registerMove(program) {
+    program
+        .command("move <id> <destination>")
+        .description("Move a domain item to a different bounded context, updating all references")
+        .option("--diff", "Show a diff of changes made")
+        .option("-r, --root <path>", "Override repository root")
+        .addHelpText("after", `
+Destination formats:
+  new-context           move to new-context with the same item name
+  new-context.NewName   move to new-context and rename
+
+Examples:
+  dkk move ordering.OrderPlaced payments
+  dkk move ordering.OrderPlaced payments.PaymentReceived
+`)
+        .action((id, destination, opts) => {
+        const parsed = classifyId(id);
+        if (parsed.kind !== "domain") {
+            console.error(`'move' only supports domain items (ctx.Name format). ` +
+                `Use 'rename' for actors, ADRs, flows, and contexts.`);
+            process.exit(1);
+        }
+        const oldCtx = parsed.ctx;
+        const oldName = parsed.name;
+        const oldId = id;
+        // Parse destination: either "new-ctx" or "new-ctx.NewName"
+        let newCtx;
+        let newName;
+        if (destination.includes(".")) {
+            const dot = destination.indexOf(".");
+            newCtx = destination.slice(0, dot);
+            newName = destination.slice(dot + 1);
+        }
+        else {
+            newCtx = destination;
+            newName = oldName;
+        }
+        const newId = `${newCtx}.${newName}`;
+        if (oldCtx === newCtx && oldName === newName) {
+            console.error("Source and destination are identical; nothing to do.");
+            process.exit(1);
+        }
+        if (oldCtx === newCtx) {
+            console.error(`Source and destination are in the same context '${oldCtx}'. Use 'dkk rename' instead.`);
+            process.exit(1);
+        }
+        const model = loadDomainModel({ root: opts.root });
+        const graph = DomainGraph.from(model);
+        if (!graph.hasNode(oldId)) {
+            console.error(`Item '${oldId}' not found.`);
+            process.exit(1);
+        }
+        if (graph.hasNode(newId)) {
+            console.error(`Target ID '${newId}' already exists.`);
+            process.exit(1);
+        }
+        if (!graph.hasNode(`context.${newCtx}`)) {
+            console.error(`Destination context '${newCtx}' does not exist. Create it first with 'dkk new context ${newCtx}'.`);
+            process.exit(1);
+        }
+        const node = graph.nodes.get(oldId);
+        if (node.kind === "glossary") {
+            console.error("Glossary terms cannot be moved across contexts; they are context-scoped by definition.");
+            process.exit(1);
+        }
+        const typeDir = KIND_TO_DIR[node.kind];
+        if (!typeDir) {
+            console.error(`Unsupported item kind '${node.kind}'.`);
+            process.exit(1);
+        }
+        const ctxBase = contextsDir(opts.root);
+        const oldDir = join(ctxBase, oldCtx, typeDir);
+        const newDir = join(ctxBase, newCtx, typeDir);
+        const oldPath = join(oldDir, `${oldName}.yml`);
+        const newPath = join(newDir, `${newName}.yml`);
+        if (!existsSync(oldPath)) {
+            console.error(`File not found: ${oldPath}`);
+            process.exit(1);
+        }
+        // 1. Update/copy the item file's `name` field and move it
+        const content = readFileSync(oldPath, "utf-8");
+        const data = parseYaml(content);
+        const nameChanged = oldName !== newName;
+        if (nameChanged) {
+            data["name"] = newName;
+        }
+        const newContent = nameChanged ? stringifyYaml(data) : content;
+        if (opts.diff) {
+            console.log(`\n--- a/${oldPath}\n+++ b/${newPath}`);
+            if (nameChanged)
+                printDiff(oldPath, content, newContent);
+            else
+                console.log(`(File moved: ${oldPath} → ${newPath})`);
+        }
+        mkdirSync(newDir, { recursive: true });
+        writeFileSync(newPath, newContent, "utf-8");
+        rmSync(oldPath);
+        // 2. Update references in all domain item files (both contexts)
+        let updated = 0;
+        // Within-context same items referencing oldName by simple name:
+        // Find items in oldCtx that reference this item
+        const oldCtxDeps = [...graph.edges]
+            .filter((e) => e.label !== "contains" &&
+            (e.to === oldId || e.from === oldId) &&
+            graph.nodes.get(e.to)?.context === oldCtx &&
+            graph.nodes.get(e.from)?.context === oldCtx)
+            .flatMap((e) => [e.to, e.from])
+            .filter((nId) => nId !== oldId)
+            .map((nId) => graph.nodes.get(nId))
+            .filter((n) => n !== undefined &&
+            n.kind !== "context" &&
+            n.kind !== "adr" &&
+            n.kind !== "flow" &&
+            n.kind !== "glossary");
+        const visited = new Set();
+        for (const depNode of oldCtxDeps) {
+            if (!depNode || visited.has(depNode.id))
+                continue;
+            visited.add(depNode.id);
+            if (!depNode.context)
+                continue;
+            const depTypeDir = KIND_TO_DIR[depNode.kind];
+            if (!depTypeDir)
+                continue;
+            const depPath = join(ctxBase, depNode.context, depTypeDir, `${depNode.name}.yml`);
+            // Remove the back-reference from old-ctx neighbors (they now reference a non-existent item)
+            // We rewrite the simple name to the new scoped id
+            if (renameDomainItemRef(depPath, depNode.kind, oldName, 
+            // Within old-ctx, the reference was by simple name. After move, the item is
+            // in a different context so cross-context references need the full scoped id.
+            newId, opts.diff ?? false))
+                updated++;
+        }
+        // Rewrite scoped ID references across all domain files (cross-context, flows, ADRs)
+        for (const filePath of allDomainFiles(opts.root)) {
+            if (filePath === newPath)
+                continue;
+            if (rewriteFile(filePath, oldId, newId, opts.diff ?? false))
+                updated++;
+        }
+        // Update flow steps
+        const steps = updateFlowStepsForItem(opts.root, oldId, newId, opts.diff ?? false);
+        if (steps > 0)
+            updated += steps;
+        // Update ADR domain_refs
+        for (const adrFilePath of allAdrFiles(opts.root)) {
+            updateAdrFrontmatter(adrFilePath, (fm) => {
+                const refs = fm["domain_refs"];
+                if (!refs?.includes(oldId))
+                    return false;
+                const idx = refs.indexOf(oldId);
+                refs[idx] = newId;
+                return true;
+            }, opts.diff ?? false);
+        }
+        console.log(`Successfully moved '${oldId}' → '${newId}'. Updated ${updated} reference(s).`);
+    });
+}
+//# sourceMappingURL=move.js.map

package/dist/features/refactor/commands/move.js.map

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

package/dist/features/refactor/commands/rename.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../../src/features/refactor/commands/rename.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAkChD,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAyIjD"}
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../../src/features/refactor/commands/rename.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAgahD,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAuDjD"}