domain-knowledge-kit 0.2.7 → 0.2.8

package/dist/features/scaffold/commands/new-adr.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `dkk new adr <title>` command — scaffold a new ADR file.
+ *
+ * Creates `.dkk/adr/adr-NNNN.md` with YAML frontmatter template.
+ * Automatically determines the next ADR number by scanning existing files.
+ *
+ * Flags:
+ *   --status accepted|proposed|deprecated  (default: proposed)
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerNewAdr(program: Cmd): void;
+//# sourceMappingURL=new-adr.d.ts.map

package/dist/features/scaffold/commands/new-adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-adr.d.ts","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/new-adr.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA2ChD,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA8DjD"}

package/dist/features/scaffold/commands/new-adr.js

@@ -0,0 +1,95 @@
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { adrDir } from "../../../shared/paths.js";
+/** Scan existing adr-NNNN.md files and return the next number. */
+function nextAdrNumber(dir) {
+    if (!existsSync(dir))
+        return 1;
+    const files = readdirSync(dir);
+    let max = 0;
+    for (const f of files) {
+        const m = f.match(/^adr-(\d{4})\.md$/);
+        if (m) {
+            const n = parseInt(m[1], 10);
+            if (n > max)
+                max = n;
+        }
+    }
+    return max + 1;
+}
+/** Pad a number to 4 digits. */
+function pad4(n) {
+    return String(n).padStart(4, "0");
+}
+/** Get today's date as YYYY-MM-DD. */
+function today() {
+    const d = new Date();
+    const year = d.getFullYear();
+    const month = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+/** Convert a title to a kebab-case slug for the filename hint. */
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+export function registerNewAdr(program) {
+    program
+        .command("adr <title>")
+        .description("Scaffold a new ADR file with frontmatter template")
+        .option("-r, --root <path>", "Override repository root")
+        .option("-s, --status <status>", "ADR status (proposed, accepted, deprecated)", "proposed")
+        .action((title, opts) => {
+        const status = opts.status ?? "proposed";
+        const validStatuses = ["proposed", "accepted", "deprecated", "superseded"];
+        if (!validStatuses.includes(status)) {
+            console.error(`Error: Invalid status "${status}". Must be one of: ${validStatuses.join(", ")}`);
+            process.exit(1);
+        }
+        const dir = adrDir(opts.root);
+        mkdirSync(dir, { recursive: true });
+        const num = nextAdrNumber(dir);
+        const id = `adr-${pad4(num)}`;
+        const filename = `${id}.md`;
+        const filePath = join(dir, filename);
+        // Guard: should not happen with auto-numbering, but be safe
+        if (existsSync(filePath)) {
+            console.error(`Error: ${filePath} already exists.`);
+            process.exit(1);
+        }
+        const _slug = slugify(title);
+        const content = `---
+id: ${id}
+title: ${title}
+status: ${status}
+date: ${today()}
+deciders: []
+domain_refs: []
+---
+
+# ${id.toUpperCase()} — ${title}
+
+**Status:** ${status.charAt(0).toUpperCase() + status.slice(1)}
+**Date:** ${today()}
+
+## Context
+
+<!-- What is the issue that we're seeing that is motivating this decision? -->
+
+## Decision
+
+<!-- What is the change that we're proposing and/or doing? -->
+
+## Consequences
+
+<!-- What becomes easier or harder as a result of this decision? -->
+`;
+        writeFileSync(filePath, content, "utf-8");
+        console.log(`Created ${filename}`);
+        console.log(`  .dkk/adr/${filename}`);
+    });
+}
+//# sourceMappingURL=new-adr.js.map

package/dist/features/scaffold/commands/new-adr.js.map

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

package/dist/features/scaffold/commands/new-context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `dkk new context <name>` command — scaffold a new bounded context.
+ *
+ * Creates:
+ *   .dkk/domain/contexts/<name>/context.yml
+ *   .dkk/domain/contexts/<name>/events/
+ *   .dkk/domain/contexts/<name>/commands/
+ *   .dkk/domain/contexts/<name>/aggregates/
+ *   .dkk/domain/contexts/<name>/policies/
+ *   .dkk/domain/contexts/<name>/read-models/
+ *
+ * Registers the context in `.dkk/domain/index.yml`.
+ * Errors if the context already exists.
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerNewContext(program: Cmd): void;
+//# sourceMappingURL=new-context.d.ts.map

package/dist/features/scaffold/commands/new-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-context.d.ts","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/new-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAYhD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAoErD"}

package/dist/features/scaffold/commands/new-context.js

@@ -0,0 +1,67 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { contextsDir, indexFile } from "../../../shared/paths.js";
+import { parseYaml, stringifyYaml } from "../../../shared/yaml.js";
+/** Validate context name is kebab-case per schema: ^[a-z][a-z0-9-]*$ */
+function isValidContextName(name) {
+    return /^[a-z][a-z0-9-]*$/.test(name);
+}
+export function registerNewContext(program) {
+    program
+        .command("context <name>")
+        .description("Scaffold a new bounded context directory and register it in index.yml")
+        .option("-r, --root <path>", "Override repository root")
+        .option("-d, --description <text>", "Description of the bounded context")
+        .action((name, opts) => {
+        // Validate name
+        if (!isValidContextName(name)) {
+            console.error(`Error: Context name "${name}" is invalid. Use kebab-case (e.g. "order-management").`);
+            process.exit(1);
+        }
+        const ctxDir = join(contextsDir(opts.root), name);
+        // Guard: refuse if context directory already exists
+        if (existsSync(ctxDir)) {
+            console.error(`Error: Context "${name}" already exists at ${ctxDir}.`);
+            process.exit(1);
+        }
+        const description = opts.description ?? `The ${name} bounded context`;
+        // Create directory structure
+        const subDirs = ["events", "commands", "aggregates", "policies", "read-models"];
+        for (const sub of subDirs) {
+            mkdirSync(join(ctxDir, sub), { recursive: true });
+        }
+        // Write context.yml
+        const contextYaml = `# Bounded context metadata and glossary.
+name: ${name}
+description: ${description}
+`;
+        writeFileSync(join(ctxDir, "context.yml"), contextYaml, "utf-8");
+        // Register in index.yml
+        const idxPath = indexFile(opts.root);
+        let index;
+        if (existsSync(idxPath)) {
+            const raw = readFileSync(idxPath, "utf-8");
+            index = parseYaml(raw);
+        }
+        else {
+            // Create index.yml if it doesn't exist
+            mkdirSync(join(idxPath, ".."), { recursive: true });
+            index = { contexts: [], flows: [] };
+        }
+        // Check if already registered
+        const alreadyRegistered = index.contexts.some((c) => c.name === name);
+        if (!alreadyRegistered) {
+            index.contexts.push({ name, description });
+            writeFileSync(idxPath, stringifyYaml(index), "utf-8");
+        }
+        console.log(`Created context "${name}":`);
+        console.log(`  contexts/${name}/context.yml`);
+        for (const sub of subDirs) {
+            console.log(`  contexts/${name}/${sub}/`);
+        }
+        if (!alreadyRegistered) {
+            console.log(`\nRegistered "${name}" in index.yml.`);
+        }
+    });
+}
+//# sourceMappingURL=new-context.js.map

package/dist/features/scaffold/commands/new-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-context.js","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/new-context.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGnE,wEAAwE;AACxE,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAY;IAC7C,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,0BAA0B,EAAE,oCAAoC,CAAC;SACxE,MAAM,CAAC,CAAC,IAAY,EAAE,IAA6C,EAAE,EAAE;QACtE,gBAAgB;QAChB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CACX,wBAAwB,IAAI,yDAAyD,CACtF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAElD,oDAAoD;QACpD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CACX,mBAAmB,IAAI,uBAAuB,MAAM,GAAG,CACxD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,kBAAkB,CAAC;QAEtE,6BAA6B;QAC7B,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QAChF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,oBAAoB;QACpB,MAAM,WAAW,GAAG;QAClB,IAAI;eACG,WAAW;CACzB,CAAC;QACI,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAEjE,wBAAwB;QACxB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,KAAkB,CAAC;QACvB,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3C,KAAK,GAAG,SAAS,CAAc,GAAG,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,KAAK,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACtC,CAAC;QAED,8BAA8B;QAC9B,MAAM,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAC3C,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,cAAc,CAAC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/features/scaffold/commands/new-domain.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `dkk new domain` command — scaffold a complete `.dkk/domain/` structure.
+ *
+ * Creates:
+ *   .dkk/domain/index.yml          — domain index with one sample context
+ *   .dkk/domain/actors.yml         — actors file with one sample actor
+ *   .dkk/domain/contexts/sample/   — example bounded context with:
+ *     context.yml, events/, commands/, aggregates/, policies/, read-models/
+ *
+ * Errors if `.dkk/domain/` already exists (use `--force` to overwrite).
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerNewDomain(program: Cmd): void;
+//# sourceMappingURL=new-domain.d.ts.map

package/dist/features/scaffold/commands/new-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-domain.d.ts","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/new-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA0DhD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA0CpD"}

package/dist/features/scaffold/commands/new-domain.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { domainDir } from "../../../shared/paths.js";
+// ── Template content ──────────────────────────────────────────────────
+const INDEX_YML = `# Domain index — registered bounded contexts and cross-context flows.
+contexts:
+  - name: sample
+    description: Example bounded context (replace with your own)
+flows: []
+`;
+const ACTORS_YML = `# Actors — people and systems that interact with the domain.
+actors:
+  - name: User
+    type: human
+    description: A person who interacts with the system
+`;
+const CONTEXT_YML = `# Bounded context metadata and glossary.
+name: sample
+description: Example bounded context (replace with your own)
+glossary:
+  - term: Example
+    definition: A sample glossary term to demonstrate the structure
+`;
+const SAMPLE_EVENT = `# Domain event — something that happened in the domain.
+name: SampleCreated
+description: Raised when a new sample entity is created
+fields:
+  - name: sampleId
+    type: UUID
+raised_by: Sample
+`;
+const SAMPLE_COMMAND = `# Command — an instruction to change domain state.
+name: CreateSample
+description: Create a new sample entity
+actor: User
+handled_by: Sample
+`;
+const SAMPLE_AGGREGATE = `# Aggregate — a consistency boundary that handles commands and emits events.
+name: Sample
+description: Sample aggregate root
+handles:
+  commands:
+    - CreateSample
+emits:
+  events:
+    - SampleCreated
+`;
+// ── Registration ──────────────────────────────────────────────────────
+export function registerNewDomain(program) {
+    program
+        .command("domain")
+        .description("Scaffold a complete .dkk/domain/ structure with sample content")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--force", "Overwrite existing .dkk/domain/ directory")
+        .action((opts) => {
+        const dir = domainDir(opts.root);
+        // Guard: refuse to overwrite unless --force
+        if (existsSync(dir) && !opts.force) {
+            console.error(`Error: ${dir} already exists. Use --force to overwrite.`);
+            process.exit(1);
+        }
+        // Create directory structure
+        const contextsBase = join(dir, "contexts", "sample");
+        const subDirs = ["events", "commands", "aggregates", "policies", "read-models"];
+        for (const sub of subDirs) {
+            mkdirSync(join(contextsBase, sub), { recursive: true });
+        }
+        // Write files
+        writeFileSync(join(dir, "index.yml"), INDEX_YML, "utf-8");
+        writeFileSync(join(dir, "actors.yml"), ACTORS_YML, "utf-8");
+        writeFileSync(join(contextsBase, "context.yml"), CONTEXT_YML, "utf-8");
+        writeFileSync(join(contextsBase, "events", "SampleCreated.yml"), SAMPLE_EVENT, "utf-8");
+        writeFileSync(join(contextsBase, "commands", "CreateSample.yml"), SAMPLE_COMMAND, "utf-8");
+        writeFileSync(join(contextsBase, "aggregates", "Sample.yml"), SAMPLE_AGGREGATE, "utf-8");
+        console.log("Created .dkk/domain/ with sample content:");
+        console.log("  index.yml");
+        console.log("  actors.yml");
+        console.log("  contexts/sample/");
+        console.log("    context.yml");
+        console.log("    events/SampleCreated.yml");
+        console.log("    commands/CreateSample.yml");
+        console.log("    aggregates/Sample.yml");
+        console.log("\nRun `dkk render` to validate and generate documentation.");
+    });
+}
+//# sourceMappingURL=new-domain.js.map

package/dist/features/scaffold/commands/new-domain.js.map

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

package/dist/shared/errors.js

@@ -41,7 +41,7 @@ export function formatCliError(err) {
         const filePath = err.path ? ` "${err.path}"` : "";
         switch (err.code) {
             case "ENOENT":
-                return `File not found:${filePath}. Check that the path exists and the domain/ directory is present.`;
+                return `File not found:${filePath}. Check that the path exists and the .dkk/domain/ directory is present.`;
             case "EACCES":
             case "EPERM":
                 return `Permission denied:${filePath}. Check file permissions.`;

package/dist/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,GAAG,YAAY,KAAK,IAAI,OAAQ,GAAuB,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnF,CAAC;AAYD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,uBAAuB;IACvB,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,qBAAqB,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,gDAAgD;YAChD,MAAM,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3E,IAAI,GAAG,GAAG,0BAA0B,MAAM,KAAK,IAAI,GAAG,QAAQ,GAAG,CAAC;YAClE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,GAAG,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,0BAA0B,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,wCAAwC;IACxC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO,kBAAkB,QAAQ,oEAAoE,CAAC;YACxG,KAAK,QAAQ,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,qBAAqB,QAAQ,2BAA2B,CAAC;YAClE,KAAK,QAAQ;gBACX,OAAO,yCAAyC,QAAQ,GAAG,CAAC;YAC9D;gBACE,OAAO,iBAAiB,GAAG,CAAC,IAAI,KAAK,QAAQ,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,GAAG,YAAY,KAAK,IAAI,OAAQ,GAAuB,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnF,CAAC;AAYD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,uBAAuB;IACvB,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,qBAAqB,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,gDAAgD;YAChD,MAAM,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3E,IAAI,GAAG,GAAG,0BAA0B,MAAM,KAAK,IAAI,GAAG,QAAQ,GAAG,CAAC;YAClE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,GAAG,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,0BAA0B,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,wCAAwC;IACxC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO,kBAAkB,QAAQ,yEAAyE,CAAC;YAC7G,KAAK,QAAQ,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,qBAAqB,QAAQ,2BAA2B,CAAC;YAClE,KAAK,QAAQ;gBACX,OAAO,yCAAyC,QAAQ,GAAG,CAAC;YAC9D;gBACE,OAAO,iBAAiB,GAAG,CAAC,IAAI,KAAK,QAAQ,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/shared/index.d.ts

@@ -9,7 +9,7 @@ export * from "./types/index.js";
 export { type ItemType, type AnyDomainItem, ITEM_TYPES, itemName, itemDescription, itemAdrRefs, forEachItem, mapItems, } from "./item-visitor.js";
 export { loadDomainModel, type LoaderOptions } from "./loader.js";
 export { DomainGraph, type NodeKind, type GraphNode, type GraphEdge } from "./graph.js";
-export { repoRoot, domainDir, contextsDir, actorsFile, indexFile, adrDir, docsDir, templatesDir, schemaDir, repoRelative, } from "./paths.js";
+export { repoRoot, packageRoot, domainDir, contextsDir, actorsFile, indexFile, adrDir, docsDir, templatesDir, schemaDir, repoRelative, } from "./paths.js";
 export { parseYaml, stringifyYaml } from "./yaml.js";
 export { parseAdrFrontmatter, parseAdrFile } from "./adr-parser.js";
 export { formatCliError, isYAMLException, isNodeSystemError } from "./errors.js";

package/dist/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGxF,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,EACN,OAAO,EACP,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGxF,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,EACN,OAAO,EACP,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/shared/index.js

@@ -14,7 +14,7 @@ export { loadDomainModel } from "./loader.js";
 // ── Graph ─────────────────────────────────────────────────────────────
 export { DomainGraph } from "./graph.js";
 // ── Path helpers ──────────────────────────────────────────────────────
-export { repoRoot, domainDir, contextsDir, actorsFile, indexFile, adrDir, docsDir, templatesDir, schemaDir, repoRelative, } from "./paths.js";
+export { repoRoot, packageRoot, domainDir, contextsDir, actorsFile, indexFile, adrDir, docsDir, templatesDir, schemaDir, repoRelative, } from "./paths.js";
 // ── YAML helpers ──────────────────────────────────────────────────────
 export { parseYaml, stringifyYaml } from "./yaml.js";
 // ── ADR parser ────────────────────────────────────────────────────────

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yEAAyE;AACzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,yEAAyE;AACzE,OAAO,EAGL,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,OAAO,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC;AAElE,yEAAyE;AACzE,OAAO,EAAE,WAAW,EAAiD,MAAM,YAAY,CAAC;AAExF,yEAAyE;AACzE,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,EACN,OAAO,EACP,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,yEAAyE;AACzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAErD,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpE,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yEAAyE;AACzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,yEAAyE;AACzE,OAAO,EAGL,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,OAAO,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC;AAElE,yEAAyE;AACzE,OAAO,EAAE,WAAW,EAAiD,MAAM,YAAY,CAAC;AAExF,yEAAyE;AACzE,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,EACN,OAAO,EACP,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,yEAAyE;AACzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAErD,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpE,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/shared/loader.js

@@ -1,13 +1,13 @@
 /**
  * Domain model loader.
  *
- * Recursively walks `domain/` and `.dkk/adr/` to discover all YAML
+ * Recursively walks `.dkk/domain/` and `.dkk/adr/` to discover all YAML
  * definition files and ADR Markdown files, then assembles and returns
  * a fully-typed {@link DomainModel}.
  *
  * Context layout (per-item directory format):
  *
- *   domain/contexts/<name>/
+ *   .dkk/domain/contexts/<name>/
  *     context.yml          ← metadata: name, description, glossary
  *     events/              ← one .yml file per DomainEvent
  *     commands/            ← one .yml file per Command

package/dist/shared/paths.d.ts

@@ -1,29 +1,50 @@
 /**
- * Resolve the repository root.
+ * Resolve the DKK package installation root.
  *
  * When running from source (`tsx src/cli.ts`) `import.meta.dirname`
- * points at `src/shared/`, so we go up two levels. When running from
+ * points at `src/shared/`, so we go up two levels.  When running from
  * the compiled output (`dist/shared/`) we also go up two levels.
  *
- * Callers can override by passing an explicit `repoRoot`.
+ * Used exclusively for locating package-bundled assets (schemas,
+ * templates).
+ */
+export declare function packageRoot(): string;
+/**
+ * Resolve the project root (where `.dkk/` lives).
+ *
+ * Defaults to `process.cwd()` so that DKK works correctly whether it
+ * is run from source, from a global install, or as a project dependency.
+ *
+ * Callers can override by passing an explicit root path (the `--root`
+ * CLI flag).
  */
 export declare function repoRoot(override?: string): string;
-/** Absolute path to the `domain/` directory. */
+/** Absolute path to the `.dkk/domain/` directory. */
 export declare function domainDir(root?: string): string;
-/** Absolute path to `domain/contexts/`. */
+/** Absolute path to `.dkk/domain/contexts/`. */
 export declare function contextsDir(root?: string): string;
-/** Absolute path to `domain/actors.yml`. */
+/** Absolute path to `.dkk/domain/actors.yml`. */
 export declare function actorsFile(root?: string): string;
-/** Absolute path to `domain/index.yml`. */
+/** Absolute path to `.dkk/domain/index.yml`. */
 export declare function indexFile(root?: string): string;
 /** Absolute path to `.dkk/adr/`. */
 export declare function adrDir(root?: string): string;
 /** Absolute path to `.dkk/docs/` (rendered output). */
 export declare function docsDir(root?: string): string;
-/** Absolute path to `tools/dkk/templates/`. */
-export declare function templatesDir(root?: string): string;
-/** Absolute path to `tools/dkk/schema/`. */
-export declare function schemaDir(root?: string): string;
+/**
+ * Absolute path to `tools/dkk/templates/`.
+ *
+ * Always resolves relative to the DKK package installation so that
+ * templates are found regardless of the user's working directory.
+ */
+export declare function templatesDir(): string;
+/**
+ * Absolute path to `tools/dkk/schema/`.
+ *
+ * Always resolves relative to the DKK package installation so that
+ * schemas are found regardless of the user's working directory.
+ */
+export declare function schemaDir(): string;
 /**
  * Turn an absolute path into a repo-relative POSIX path
  * (forward slashes, no leading `./`).

package/dist/shared/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/shared/paths.js

@@ -1,38 +1,58 @@
 /**
- * Repo-relative path resolution utilities.
+ * Path resolution utilities.
  *
- * Every path helper resolves relative to the repository root
- * so callers never need to worry about the working directory.
+ * Two resolution strategies:
+ *
+ * 1. **Project paths** (`repoRoot`, `domainDir`, `docsDir`, …) resolve
+ *    from `process.cwd()` (or an explicit `--root` override).  This is
+ *    the user's project directory — where `.dkk/domain/` lives.
+ *
+ * 2. **Package asset paths** (`packageRoot`, `schemaDir`, `templatesDir`)
+ *    resolve from `import.meta.dirname` relative to the DKK package
+ *    install.  Schemas and Handlebars templates ship with the package.
  */
 import { resolve, join, relative } from "node:path";
 /**
- * Resolve the repository root.
+ * Resolve the DKK package installation root.
  *
  * When running from source (`tsx src/cli.ts`) `import.meta.dirname`
- * points at `src/shared/`, so we go up two levels. When running from
+ * points at `src/shared/`, so we go up two levels.  When running from
  * the compiled output (`dist/shared/`) we also go up two levels.
  *
- * Callers can override by passing an explicit `repoRoot`.
+ * Used exclusively for locating package-bundled assets (schemas,
+ * templates).
+ */
+export function packageRoot() {
+    // import.meta.dirname is src/shared  or dist/shared
+    return resolve(import.meta.dirname, "../..");
+}
+/**
+ * Resolve the project root (where `.dkk/` lives).
+ *
+ * Defaults to `process.cwd()` so that DKK works correctly whether it
+ * is run from source, from a global install, or as a project dependency.
+ *
+ * Callers can override by passing an explicit root path (the `--root`
+ * CLI flag).
  */
 export function repoRoot(override) {
     if (override)
         return resolve(override);
-    // import.meta.dirname is src/shared  or dist/shared
-    return resolve(import.meta.dirname, "../..");
+    return resolve(process.cwd());
 }
-/** Absolute path to the `domain/` directory. */
+/** Absolute path to the `.dkk/domain/` directory. */
 export function domainDir(root) {
-    return join(repoRoot(root), "domain");
+    return join(repoRoot(root), ".dkk", "domain");
 }
-/** Absolute path to `domain/contexts/`. */
+/** Absolute path to `.dkk/domain/contexts/`. */
 export function contextsDir(root) {
     return join(domainDir(root), "contexts");
 }
-/** Absolute path to `domain/actors.yml`. */
+/** Absolute path to `.dkk/domain/actors.yml`. */
 export function actorsFile(root) {
     return join(domainDir(root), "actors.yml");
 }
-/** Absolute path to `domain/index.yml`. */
+/** Absolute path to `.dkk/domain/index.yml`. */
 export function indexFile(root) {
     return join(domainDir(root), "index.yml");
 }
@@ -44,13 +64,23 @@ export function adrDir(root) {
 export function docsDir(root) {
     return join(repoRoot(root), ".dkk", "docs");
 }
-/** Absolute path to `tools/dkk/templates/`. */
-export function templatesDir(root) {
-    return join(repoRoot(root), "tools", "dkk", "templates");
+/**
+ * Absolute path to `tools/dkk/templates/`.
+ *
+ * Always resolves relative to the DKK package installation so that
+ * templates are found regardless of the user's working directory.
+ */
+export function templatesDir() {
+    return join(packageRoot(), "tools", "dkk", "templates");
 }
-/** Absolute path to `tools/dkk/schema/`. */
-export function schemaDir(root) {
-    return join(repoRoot(root), "tools", "dkk", "schema");
+/**
+ * Absolute path to `tools/dkk/schema/`.
+ *
+ * Always resolves relative to the DKK package installation so that
+ * schemas are found regardless of the user's working directory.
+ */
+export function schemaDir() {
+    return join(packageRoot(), "tools", "dkk", "schema");
 }
 /**
  * Turn an absolute path into a repo-relative POSIX path

package/dist/shared/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAiB;IACxC,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,oDAAoD;IACpD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,IAAa;IAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,IAAa;IACzD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IACzB,oDAAoD;IACpD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAiB;IACxC,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,IAAa;IAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,IAAa;IACzD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC"}