feat: add validate --input option and refactor project structure (#8)

## Major Changes

### Add --input option to validate command
- Support validating specific mapdb.json files via --input/-i flag
- Maintains backward compatibility with existing tmp dir behavior
- Perfect for CI/CD pipelines and automated workflows

### Project Structure Refactor
- Rename mapdb/ → src/ (conventional structure)
- Rename mapdb.ts → cartographer.ts (matches CLI tool name)
- Update all imports and references throughout codebase

### Consistent Branding
- CLI now shows "cartographer" instead of "mapdb" in help
- Dynamic version reading from package.json
- Binary output: dist/cartographer (was dist/mapdb)
- GitHub release assets updated to upload dist/cartographer

### Code Cleanup
- Consolidate duplicate validation logic into single validateMapdb function
- Remove unused validate.ts (replaced by validateMapdb)
- All tests passing with updated imports and structure

## Usage Examples

```bash
# Validate specific file (new)
bunx @elanthia/cartographer validate --input ./mapdb.json

# Validate from tmp dir (existing behavior)
bunx @elanthia/cartographer validate

# Version and help now show proper branding
bunx @elanthia/cartographer --version  # 0.4.0
bunx @elanthia/cartographer --help     # Usage: cartographer [options]
```

This enables the GitHub Actions PR validation workflow in the mapdb repository
to validate built mapdb.json files directly without tmp directory conventions.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <[email protected]>

Author: ondreian

.github/workflows/release-please.yaml

@@ -50,4 +50,4 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          gh release upload ${{ needs.release-please.outputs.tag_name }} dist/mapdb --clobber
+          gh release upload ${{ needs.release-please.outputs.tag_name }} dist/cartographer --clobber

mapdb/tasks/validate.ts

@@ -1,16 +1,16 @@
 {
   "name": "@elanthia/cartographer",
-  "module": "mapdb/index.ts",
+  "module": "src/index.ts",
   "version": "0.4.0",
   "files": [
-    "mapdb/**/*"
+    "src/**/*"
   ],
   "type": "module",
   "scripts": {
-    "compile": "bun build --compile ./mapdb/mapdb.ts --outfile=dist/mapdb"
+    "compile": "bun build --compile ./src/cartographer.ts --outfile=dist/cartographer"
   },
   "bin": {
-    "mapdb": "./mapdb/mapdb.ts"
+    "cartographer": "./src/cartographer.ts"
   },
   "devDependencies": {
     "bun-types": "latest"

package.json

@@ -3,6 +3,11 @@ import ora from "ora"
 import { program } from "commander"
 import * as Tasks from "./tasks"
 import * as Project from "./project"
+import packageJson from "../package.json"
+
+program
+  .name("cartographer")
+  .version(packageJson.version)
 
 program.command("download")
   .alias("dl")
@@ -23,24 +28,29 @@ program.command("download")
 
 program.command("validate")
   .alias("v")
-  .description("validate a mapdb in the local tmp dir")
+  .description("validate a mapdb file")
   .option("--dr", "run in dragonrealms mode", false)
-  .action(async (args: {dr: boolean})=> {
-    const project = args.dr ? Project.Dragonrealms : Project.Gemstone
+  .option("-i, --input <file>", "input mapdb.json file path")
+  .action(async (args: {dr: boolean, input?: string})=> {
+    const baseProject = args.dr ? Project.Dragonrealms : Project.Gemstone
     const then = performance.now()
     const spinner = ora()
-    spinner.start(`validating mapdb at ${project.route("/map.json")}...`)
-    const {rooms, errors} = await Tasks.validate({project})
+    
+    // Use input file or default to tmp directory path
+    const filePath = args.input || baseProject.route("/map.json")
+    
+    spinner.start(`validating mapdb at ${filePath}...`)
+    const {rooms, errors} = await Tasks.validateMapdb({filePath})
     const runtime = Math.round(performance.now() - then)
 
     if (errors.length == 0) {
       spinner.succeed(`[${runtime}ms] validated ${rooms.length} rooms`)
       return process.exit(0)
     }
+    
     spinner.clear()
     console.table(errors)
     spinner.fail(`[${runtime}ms] found ${errors.length} issues`)
-
     process.exit(1)
   })
 

mapdb/mapdb.ts renamed to src/cartographer.ts

@@ -2,7 +2,7 @@ import type { Ora } from "ora";
 import {type Project} from "../project"
 import { State, Room } from "../room/room";
 import { download } from "./download";
-import { validate } from "./validate"
+import { validateMapdb } from "./validate-mapdb"
 
 /**
  * Tracks the results of git operations performed on rooms
@@ -45,7 +45,7 @@ export async function git (config : SeedConfig) {
     await config.project.gitSetup()
   }
 
-  const {errors: validationErrors, rooms} = await validate(config)
+  const {errors: validationErrors, rooms} = await validateMapdb({filePath: config.project.route("/map.json")})
   const operations: Operations = {
     updated: 0,
     skipped: 0,

mapdb/project.ts renamed to src/project.ts

@@ -1,6 +1,6 @@
 import { download } from "./download"
-import { validate } from "./validate"
 import { git } from "./git"
 import { reconstruct } from "./reconstruct"
 import { validateFiles } from "./validate-files"
-export { download, validate, git, reconstruct, validateFiles }
+import { validateMapdb } from "./validate-mapdb"
+export { download, git, reconstruct, validateFiles, validateMapdb }