modscape 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modscape",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Modscape: A YAML-driven data modeling visualizer CLI",
   "repository": {
     "type": "git",

package/src/create.js

@@ -0,0 +1,45 @@
+import { confirm } from '@inquirer/prompts';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export async function createModel(filePath) {
+  // 1. Extension Handling
+  if (!filePath.endsWith('.yaml') && !filePath.endsWith('.yml')) {
+    filePath += '.yaml';
+  }
+
+  const absolutePath = path.resolve(process.cwd(), filePath);
+  const dir = path.dirname(absolutePath);
+
+  // 2. Recursive Directory Creation
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+    console.log(`  Created directory: ${path.relative(process.cwd(), dir)}`);
+  }
+
+  // 3. Overwrite Protection
+  if (fs.existsSync(absolutePath)) {
+    const overwrite = await confirm({
+      message: `File ${filePath} already exists. Overwrite with template?`,
+      default: false,
+    });
+    if (!overwrite) {
+      console.log(`  Operation cancelled. File ${filePath} preserved.`);
+      return;
+    }
+  }
+
+  // 4. Template Writing
+  try {
+    const templatePath = path.join(__dirname, 'templates/default-model.yaml');
+    const template = fs.readFileSync(templatePath, 'utf8');
+    fs.writeFileSync(absolutePath, template, 'utf8');
+    console.log(`  ✅ Successfully created new model: ${filePath}`);
+    console.log(`  🚀 Run 'modscape dev ${filePath}' to start modeling.`);
+  } catch (error) {
+    console.error(`  ❌ Failed to create model: ${error.message}`);
+  }
+}

package/src/index.js

@@ -7,6 +7,7 @@ import { startDevServer } from './dev.js';
 import { build } from './build.js';
 import { initProject } from './init.js';
 import { exportModel } from './export.js';
+import { createModel } from './create.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const VISUALIZER_PATH = path.resolve(__dirname, '../visualizer');
@@ -15,7 +16,7 @@ const program = new Command();
 program
   .name('modscape')
   .description('Modscape: A YAML-driven data modeling visualizer CLI')
-  .version('1.0.5');
+  .version('1.0.7');
 
 program
   .command('init')
@@ -28,6 +29,14 @@ program
     initProject(options);
   });
 
+program
+  .command('new')
+  .description('Create a new YAML model file from template')
+  .argument('<path>', 'path to the new YAML file')
+  .action((path) => {
+    createModel(path);
+  });
+
 program
   .command('dev')
   .description('Start the development visualizer with local YAML files or directories')

package/src/templates/default-model.yaml

@@ -0,0 +1,61 @@
+# Modscape Data Model
+# Use 'modscape dev <filename>' to visualize and edit this model.
+
+domains:
+  - id: sample_domain
+    name: Sample Domain
+    color: "rgba(59, 130, 246, 0.1)"
+    description: "A logical grouping of related business entities."
+    tables: [source_table, derived_table]
+
+tables:
+  - id: source_table
+    name: Source Table
+    logical_name: "Original Business Record"
+    physical_name: "raw_source_table"
+    appearance:
+      type: table
+      icon: "📋"
+    columns:
+      - id: id
+        logical: { name: ID, type: Int, isPrimaryKey: true }
+        physical: { name: id, type: BIGINT }
+      - id: name
+        logical: { name: Name, type: String }
+        physical: { name: name, type: VARCHAR(255) }
+    sampleData:
+      - [id, name]
+      - [1, "Example Record A"]
+      - [2, "Example Record B"]
+
+  - id: derived_table
+    name: Derived Mart
+    logical_name: "Processed Analytics Summary"
+    physical_name: "mart_derived_summary"
+    appearance:
+      type: mart
+      icon: "📈"
+    lineage:
+      upstream: [source_table] # Lineage: Defines the flow of data (dashed arrows)
+    columns:
+      - id: id
+        logical: { name: ID, type: Int, isPrimaryKey: true }
+        physical: { name: id, type: BIGINT }
+      - id: source_id
+        logical: { name: Source ID, type: Int, isForeignKey: true }
+        physical: { name: source_id, type: BIGINT }
+      - id: summary_value
+        logical: { name: Value, type: Decimal, additivity: fully }
+        physical: { name: total_val, type: NUMBER(18,2) }
+    sampleData:
+      - [id, source_id, summary_value]
+      - [101, 1, 150.50]
+      - [102, 2, 300.75]
+
+relationships:
+  # Relationships: Defines Entity-Relationship connections (solid lines with 1:M badges)
+  - from: { table: source_table, column: id }
+    to: { table: derived_table, column: source_id }
+    type: one-to-many
+
+lineage: [] # Note: Table-level lineage is also supported here, or inside tables[].lineage

package/visualizer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "visualizer",
   "private": true,
-  "version": "1.0.5",
+  "version": "1.0.7",
   "type": "module",
   "scripts": {
     "dev": "vite",