@genvidtech/c3-domain-manager 0.0.1 → 0.6.1

package/LICENSE

@@ -0,0 +1,18 @@
+MIT No Attribution
+
+Copyright (c) 2026 Genvid Technologies, inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,45 +1,211 @@
-# @genvidtech/c3-domain-manager
+# c3-domain-manager
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Domain-driven design analysis for Construct 3 projects. Classifies source files into domains, parses event sheet dependencies, and provides health and boundary validation — all driven by a single `domain-config.json` file.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## What it does
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+- **File classification** — maps `eventSheets/`, `layouts/`, and `scripts/` files to named domains using directory patterns and per-file overrides
+- **Domain index generation** — writes markdown pages to `extracted/domain-index/` with per-domain file lists, function signatures, and include graphs
+- **Health metrics** — computes coupling (Ca/Ce) and instability scores for each domain
+- **Boundary validation** — detects undeclared cross-domain dependencies and forbidden dependency directions
+- **Glossary collision detection** — flags terms defined differently across domains
+- **Context map** — generates text or Mermaid diagrams of inter-domain relationships
+- **Editor-strictness validation** — reports event sheets the C3 editor would refuse to import (e.g. missing required fields on `variable` or `group` events)
+- **MCP server** — exposes all of the above as Model Context Protocol tools for AI agents
 
-## Purpose
+## Requirements
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@genvidtech/c3-domain-manager`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+- Node.js >= 22
+- A Construct 3 project with `eventSheets/`, `layouts/`, and `scripts/` directories
+- A `domain-config.json` at the project root (see [docs/domain-architecture.md](docs/domain-architecture.md))
 
-## What is OIDC Trusted Publishing?
+## Installation
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+Install from npm:
 
-## Setup Instructions
+```bash
+npm install @genvidtech/c3-domain-manager
+```
 
-To properly configure OIDC trusted publishing for this package:
+Or run the CLI without installing:
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+```bash
+npx @genvidtech/c3-domain-manager generate
+```
 
-## DO NOT USE THIS PACKAGE
+## Quick start
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+### 1. Create domain-config.json
 
-## More Information
+At the root of your Construct 3 project:
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+```json
+{
+  "domains": {
+    "Authentication": {
+      "description": "Login, device binding, user profile",
+      "eventSheetDirs": ["Login", "Profile"],
+      "layoutDirs": ["Login"],
+      "scriptDirs": ["Auth"]
+    },
+    "Gameplay": {
+      "description": "Battle loop, enemies, skills",
+      "eventSheetDirs": ["Battle", "Enemies"],
+      "layoutDirs": ["Levels"],
+      "scriptDirs": ["Battle", "Skills"]
+    }
+  },
+  "sharedSubdomains": {
+    "UI Components": {
+      "description": "Reusable UI widgets used across domains",
+      "scriptDirs": ["UI"]
+    }
+  },
+  "overrides": {
+    "eventSheets/Shared/ChatEvents.json": "Watch Content"
+  }
+}
+```
 
----
+### 2. Generate the domain index
 
-**Maintained for OIDC setup purposes only**
+Run from your project root:
+
+```bash
+npx @genvidtech/c3-domain-manager generate
+```
+
+This writes markdown pages to `extracted/domain-index/`.
+
+### 3. Check coverage
+
+```bash
+npx @genvidtech/c3-domain-manager list-uncategorized
+```
+
+Lists files not covered by any domain mapping.
+
+## CLI reference
+
+Run any subcommand with `--help` for full usage.
+
+| Subcommand | Description |
+|------------|-------------|
+| `generate` | Generate domain index at `extracted/domain-index/` |
+| `list-uncategorized` | List files not mapped to any domain |
+| `list-stale-overrides` | List override entries pointing to non-existent files |
+| `validate-editor` | Report event sheets the C3 editor would reject (editor-strictness validation) |
+| `server` | Start the MCP server (stdio transport) |
+
+All subcommands share three global options:
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--project-dir <path>` | auto-detected | C3 project source root (`eventSheets/`, `layouts/`, `scripts/`). Auto-detected from a `project.c3proj` marker in the current dir or an immediate child; also honoured via the `C3_PROJECT_DIR` env var. Relative paths resolve from the current directory. |
+| `--config <path>` | `<project-root>/domain-config.json` | Path to `domain-config.json`. Relative paths resolve from the project root. |
+| `--extracted <path>` | `<project-root>/extracted` | Output directory for the generated domain index. Pass `none` for an ephemeral temp dir auto-cleaned on exit. |
+
+See [docs/domain-architecture.md](docs/domain-architecture.md#paths-and-locations) for the full `--project-dir` resolution precedence (flag > `C3_PROJECT_DIR` > `project.c3proj` discovery > cwd).
+
+## MCP server
+
+The MCP server exposes 13 tools over stdio, suitable for use with Claude or any MCP-compatible client.
+
+### Starting the server
+
+```bash
+npx @genvidtech/c3-domain-manager server
+```
+
+Or in an MCP client config (e.g. Claude Desktop `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "c3-domain-manager": {
+      "command": "npx",
+      "args": ["@genvidtech/c3-domain-manager", "server"],
+      "cwd": "/path/to/your/c3-project"
+    }
+  }
+}
+```
+
+The server auto-generates the domain index on startup if `extracted/domain-index/` does not exist.
+
+### Available tools
+
+**Read tools** (no side effects)
+
+| Tool | Description |
+|------|-------------|
+| `read-domain-index` | Read the master index or a named domain's detail page. Supports `offset`/`limit` pagination. |
+| `read-domain-config` | Read `domain-config.json` in formatted text. Filter by `section`: `domains`, `sharedSubdomains`, `overrides`, or `all`. |
+| `list-uncategorized` | List files with no domain assignment. |
+| `list-stale-overrides` | List override entries whose files no longer exist on disk. |
+| `get-state` | Return current `txId` and `domainDirty` flag. |
+| `glossary-check` | Report glossary terms that are defined differently across domains. |
+| `validate-boundaries` | Report undeclared cross-domain dependencies and forbidden dependency directions. |
+| `domain-health` | Compute Ca, Ce, and instability metrics per domain. |
+| `context-map` | Generate a context map in `text` or `mermaid` format. |
+| `validate-editor` | Report event sheets the C3 editor would reject. Re-walks sheets fresh from disk; never reads the cached domain index. |
+
+**Mutate tools** (modify `domain-config.json`)
+
+| Tool | Description |
+|------|-------------|
+| `set-overrides` | Add or update file-to-domain override entries. Accepts optional `txId` for optimistic concurrency. |
+| `remove-overrides` | Remove override entries by file path. |
+
+**Regenerate tools**
+
+| Tool | Description |
+|------|-------------|
+| `regenerate` | Re-run the domain index generator and clear the `domainDirty` flag. |
+
+### Stale index warning
+
+If `domain-config.json` changes while the server is running, mutate tools mark the index as dirty. Read tools that depend on the index append a warning: `[Warning: domain index may be stale — run regenerate to refresh]`. Call `regenerate` to clear it.
+
+### Optimistic concurrency
+
+`set-overrides` and `remove-overrides` accept an optional `txId`. If provided, the write is rejected when the server's current `txId` does not match. Use `get-state` to read the current `txId` before a write sequence.
+
+## Library API
+
+Import directly in TypeScript:
+
+```typescript
+import {
+  classifyFile,
+  generateDomainIndex,
+  computeDomainData,
+  listUncategorized,
+  listStaleOverrides,
+  validateEditorStrictness,
+  formatEditorStrictnessReport,
+} from "@genvidtech/c3-domain-manager";
+```
+
+Key exports from `src/index.ts`:
+
+| Export | Module | Description |
+|--------|--------|-------------|
+| `classifyFile(path, fileType, config)` | `classification` | Classify one file path into a domain name |
+| `generateDomainIndex(root, extracted, configDir, configFileName, log)` → `Promise` | `domainGenerator` | Async I/O entry point — validates config via `DomainConfigSchema`, writes index |
+| `computeDomainData(root, config)` | `domainGenerator` | Pure computation — returns `DomainData[]` without I/O |
+| `listUncategorized(root, config)` | `domainAnalysis` | Return file paths not covered by the config |
+| `listStaleOverrides(root, config)` | `domainAnalysis` | Return override keys whose files are missing |
+| `collectGlossary(config)` | `glossary` | Collect all glossary entries across domains |
+| `findCollisions(entries)` | `glossary` | Find terms with conflicting definitions |
+| `validateBoundaries(domains, config, filter?)` | `relationships` | Check declared vs observed dependencies |
+| `computeHealth(domain)` | `health` | Ca, Ce, instability for one `DomainData` |
+| `generateContextMap(domains, config, opts)` | `contextMap` | Produce text or Mermaid context map |
+| `validateEditorStrictness(root, config, log?)` | `editorValidation` | Re-walk event sheets and return issues grouped by sheet |
+| `formatEditorStrictnessReport(report)` | `editorValidation` | Render an `EditorStrictnessReport` to text |
+
+Type definitions are in `src/domain/types.ts`: `DomainConfig`, `DomainDefinition`, `SharedSubdomainDefinition`, `DomainData`, `Relationship`, `FunctionDef`. Editor-validation types (`EditorStrictnessReport`, `EditorStrictnessSheetReport`) are in `src/domain/editorValidation.ts`.
+
+## Further reading
+
+- [docs/domain-architecture.md](docs/domain-architecture.md) — domain model concepts, configuration schema, classification rules

package/dist/adapters/locations.d.ts

@@ -0,0 +1,22 @@
+import { type ResolvedRoot } from "@genvidtech/mcp-utils";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare const NO_EXTRACTED = "none";
+export interface LocationOptions {
+    config?: string;
+    extracted?: string;
+    projectDir?: string;
+}
+export interface ResolvedLocations {
+    projectRoot: string;
+    configPath: string;
+    configDir: string;
+    configFileName: string;
+    extractedDir: string;
+    extractedEphemeral: boolean;
+    configWatchKey: string;
+}
+export declare function resolveLocations(opts: LocationOptions, projectRoot: string, mkTempDir?: () => string): ResolvedLocations;
+export declare function resolveProjectRoot(opts: {
+    projectDir?: string;
+}, cwd?: string, env?: NodeJS.ProcessEnv): ResolvedRoot | CallToolResult;
+//# sourceMappingURL=locations.d.ts.map

package/dist/adapters/locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../../src/adapters/locations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,MAAwE,GACxF,iBAAiB,CA8BnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7B,GAAG,GAAE,MAAsB,EAC3B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,YAAY,GAAG,cAAc,CAK/B"}

package/dist/adapters/locations.js

@@ -0,0 +1,42 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { resolveRootFolder } from "@genvidtech/mcp-utils";
+import { PROJECT_MANIFEST_FILE } from "@genvidtech/c3source";
+export const NO_EXTRACTED = "none";
+function toForwardSlash(p) {
+    return p.replace(/\\/g, "/");
+}
+export function resolveLocations(opts, projectRoot, mkTempDir = () => fs.mkdtempSync(path.join(os.tmpdir(), "c3dm-extracted-"))) {
+    const configPath = opts.config
+        ? path.resolve(projectRoot, opts.config)
+        : path.join(projectRoot, "domain-config.json");
+    let extractedDir;
+    let extractedEphemeral;
+    if (opts.extracted === NO_EXTRACTED) {
+        extractedDir = mkTempDir();
+        extractedEphemeral = true;
+    }
+    else if (opts.extracted) {
+        extractedDir = path.resolve(projectRoot, opts.extracted);
+        extractedEphemeral = false;
+    }
+    else {
+        extractedDir = path.join(projectRoot, "extracted");
+        extractedEphemeral = false;
+    }
+    const configWatchKey = toForwardSlash(path.resolve(configPath));
+    return {
+        projectRoot,
+        configPath,
+        configDir: path.dirname(configPath),
+        configFileName: path.basename(configPath),
+        extractedDir,
+        extractedEphemeral,
+        configWatchKey,
+    };
+}
+export function resolveProjectRoot(opts, cwd = process.cwd(), env = process.env) {
+    return resolveRootFolder({ explicit: opts.projectDir, envVar: "C3_PROJECT_DIR", marker: PROJECT_MANIFEST_FILE, cwd }, env);
+}
+//# sourceMappingURL=locations.js.map

package/dist/adapters/locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../src/adapters/locations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAqB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAkBnC,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAqB,EACrB,WAAmB,EACnB,YAA0B,GAAG,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAEzF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM;QAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAEjD,IAAI,YAAoB,CAAC;IACzB,IAAI,kBAA2B,CAAC;IAEhC,IAAI,IAAI,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;QACpC,YAAY,GAAG,SAAS,EAAE,CAAC;QAC3B,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;SAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,kBAAkB,GAAG,KAAK,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACnD,kBAAkB,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAEhE,OAAO;QACL,WAAW;QACX,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QACnC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QACzC,YAAY;QACZ,kBAAkB;QAClB,cAAc;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAA6B,EAC7B,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,iBAAiB,CACtB,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,EAC3F,GAAG,CACJ,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+import { readFileSync, rmSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { generateDomainIndex, loadConfig } from "./domain/domainGenerator.js";
+import { listUncategorized, listStaleOverrides } from "./domain/domainAnalysis.js";
+import { validateEditorStrictness, formatEditorStrictnessReport } from "./domain/editorValidation.js";
+import { resolveLocations, resolveProjectRoot } from "./adapters/locations.js";
+import { isMcpError } from "@genvidtech/mcp-utils";
+function resolveRootOrExit(projectDir) {
+    const rooted = resolveProjectRoot({ projectDir });
+    if (isMcpError(rooted)) {
+        const msg = (rooted.content ?? [])
+            .map((c) => (typeof c.text === "string" ? c.text : ""))
+            .join("\n")
+            .trim();
+        console.error(msg || "Failed to resolve project root.");
+        process.exit(1);
+    }
+    return rooted.path;
+}
+// Resolve this package's own package.json relative to the compiled module
+// (dist/cli.js → ../package.json), NOT process.cwd() which is the target project.
+const PKG_PATH = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+const { version: PKG_VERSION } = JSON.parse(readFileSync(PKG_PATH, "utf-8"));
+yargs(hideBin(process.argv))
+    .command("server", "Start the c3-domain-manager MCP server", () => { }, async (argv) => {
+    const projectRoot = resolveRootOrExit(argv["project-dir"]);
+    const loc = resolveLocations({ config: argv.config, extracted: argv.extracted }, projectRoot);
+    const { startServer } = await import("./mcp/server.js");
+    await startServer(loc);
+})
+    .command("generate", "Generate domain index", () => { }, async (argv) => {
+    const projectRoot = resolveRootOrExit(argv["project-dir"]);
+    const loc = resolveLocations({ config: argv.config, extracted: argv.extracted }, projectRoot);
+    try {
+        await generateDomainIndex(loc.projectRoot, loc.extractedDir, loc.configDir, loc.configFileName, console.log);
+    }
+    finally {
+        if (loc.extractedEphemeral) {
+            rmSync(loc.extractedDir, { recursive: true, force: true });
+        }
+    }
+})
+    .command("list-uncategorized", "List files not mapped to any domain in domain-config.json", () => { }, async (argv) => {
+    const projectRoot = resolveRootOrExit(argv["project-dir"]);
+    const loc = resolveLocations({ config: argv.config }, projectRoot);
+    const config = await loadConfig(loc.configDir, loc.configFileName);
+    const files = listUncategorized(loc.projectRoot, config);
+    if (files.length === 0) {
+        console.log("All files are categorized.");
+    }
+    else {
+        console.log(`${files.length} uncategorized file(s):\n`);
+        for (const f of files)
+            console.log(f);
+    }
+})
+    .command("list-stale-overrides", "List stale file overrides in domain-config.json", () => { }, async (argv) => {
+    const projectRoot = resolveRootOrExit(argv["project-dir"]);
+    const loc = resolveLocations({ config: argv.config }, projectRoot);
+    const config = await loadConfig(loc.configDir, loc.configFileName);
+    const stale = listStaleOverrides(loc.projectRoot, config);
+    if (stale.length === 0) {
+        console.log("No stale overrides.");
+    }
+    else {
+        console.log(`${stale.length} stale override(s):\n`);
+        for (const s of stale)
+            console.log(s);
+    }
+})
+    .command("validate-editor", "Report event sheets the C3 editor would reject (editor-strictness validation)", () => { }, async (argv) => {
+    const projectRoot = resolveRootOrExit(argv["project-dir"]);
+    const loc = resolveLocations({ config: argv.config }, projectRoot);
+    const config = await loadConfig(loc.configDir, loc.configFileName);
+    const report = validateEditorStrictness(loc.projectRoot, config);
+    console.log(formatEditorStrictnessReport(report));
+})
+    .option("project-dir", {
+    type: "string",
+    describe: "Path to the C3 project root to analyze (default: auto-detected — the current directory or an immediate child containing project.c3proj, else the current directory). Honors the C3_PROJECT_DIR env var. Relative paths resolve from the current directory.",
+})
+    .option("config", {
+    type: "string",
+    describe: "Path to domain-config.json (default: <project-root>/domain-config.json). Relative paths resolve from the project root; absolute paths are used as-is.",
+})
+    .option("extracted", {
+    type: "string",
+    describe: 'Output directory for the generated domain index (default: <project-root>/extracted). Use "none" for an ephemeral temp dir auto-cleaned on exit.',
+})
+    .demandCommand(1, "Please specify a subcommand. Use --help for available commands.")
+    .strict()
+    .version(PKG_VERSION)
+    .help()
+    .parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/domain/classification.d.ts

@@ -0,0 +1,8 @@
+import type { DomainConfig } from "./types.js";
+/**
+ * Classify a file into a domain by checking overrides first, then directory arrays.
+ * Checks both domains and sharedSubdomains.
+ * Returns the domain name or null if unclassified.
+ */
+export declare function classifyFile(relativePath: string, fileType: "eventSheet" | "layout" | "script", config: DomainConfig): string | null;
+//# sourceMappingURL=classification.d.ts.map

package/dist/domain/classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../../src/domain/classification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAgBjE;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,QAAQ,EAC5C,MAAM,EAAE,YAAY,GACnB,MAAM,GAAG,IAAI,CAoDf"}

package/dist/domain/classification.js

@@ -0,0 +1,66 @@
+/** File type root directories. */
+const FILE_TYPE_ROOTS = {
+    eventSheet: "eventSheets/",
+    layout: "layouts/",
+    script: "scripts/",
+};
+/** Dir array key per file type. */
+const DIR_KEYS = {
+    eventSheet: "eventSheetDirs",
+    layout: "layoutDirs",
+    script: "scriptDirs",
+};
+/**
+ * Classify a file into a domain by checking overrides first, then directory arrays.
+ * Checks both domains and sharedSubdomains.
+ * Returns the domain name or null if unclassified.
+ */
+export function classifyFile(relativePath, fileType, config) {
+    // 1. Check overrides (exact match, highest priority)
+    if (config.overrides && relativePath in config.overrides) {
+        return config.overrides[relativePath];
+    }
+    // 2. Strip the file type root prefix to get the inner path
+    const root = FILE_TYPE_ROOTS[fileType];
+    if (!relativePath.startsWith(root)) {
+        return null;
+    }
+    const innerPath = relativePath.slice(root.length); // e.g. "Login/LoginEvents.json"
+    // 3. Check domain directory arrays — longest prefix wins
+    const dirKey = DIR_KEYS[fileType];
+    let bestMatch = null;
+    let bestLength = -1;
+    // Check regular domains
+    for (const [domainName, domainDef] of Object.entries(config.domains)) {
+        const dirs = domainDef[dirKey];
+        if (!dirs)
+            continue;
+        for (const dir of dirs) {
+            // dir is relative to the file type root, e.g. "Login" or "Main Menu/Shop"
+            // Match innerPath that starts with dir + "/" (file inside dir)
+            // or exactly equals dir (directory entry without trailing slash)
+            const prefix = dir + "/";
+            if ((innerPath.startsWith(prefix) || innerPath === dir) && dir.length > bestLength) {
+                bestMatch = domainName;
+                bestLength = dir.length;
+            }
+        }
+    }
+    // Check shared subdomains
+    if (config.sharedSubdomains) {
+        for (const [subdomainName, subdomainDef] of Object.entries(config.sharedSubdomains)) {
+            const dirs = subdomainDef[dirKey];
+            if (!dirs)
+                continue;
+            for (const dir of dirs) {
+                const prefix = dir + "/";
+                if ((innerPath.startsWith(prefix) || innerPath === dir) && dir.length > bestLength) {
+                    bestMatch = subdomainName;
+                    bestLength = dir.length;
+                }
+            }
+        }
+    }
+    return bestMatch;
+}
+//# sourceMappingURL=classification.js.map

package/dist/domain/classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.js","sourceRoot":"","sources":["../../src/domain/classification.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,MAAM,eAAe,GAA2B;IAC9C,UAAU,EAAE,cAAc;IAC1B,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF,mCAAmC;AACnC,MAAM,QAAQ,GAA2C;IACvD,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,YAAoB,EACpB,QAA4C,EAC5C,MAAoB;IAEpB,qDAAqD;IACrD,IAAI,MAAM,CAAC,SAAS,IAAI,YAAY,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACzD,OAAO,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED,2DAA2D;IAC3D,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gCAAgC;IAEnF,yDAAyD;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpB,wBAAwB;IACxB,KAAK,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAyB,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,0EAA0E;YAC1E,+DAA+D;YAC/D,iEAAiE;YACjE,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBACnF,SAAS,GAAG,UAAU,CAAC;gBACvB,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAyB,CAAC;YAC1D,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC;gBACzB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;oBACnF,SAAS,GAAG,aAAa,CAAC;oBAC1B,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/domain/contextMap.d.ts

@@ -0,0 +1,8 @@
+import type { DomainConfig, DomainData } from "./types.js";
+export interface ContextMapOptions {
+    format: "text" | "mermaid";
+    domain?: string;
+    includeObserved?: boolean;
+}
+export declare function generateContextMap(domains: DomainData[], config: DomainConfig, opts: ContextMapOptions): string;
+//# sourceMappingURL=contextMap.d.ts.map

package/dist/domain/contextMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextMap.d.ts","sourceRoot":"","sources":["../../src/domain/contextMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiND,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,iBAAiB,GACtB,MAAM,CAUR"}