@vizualmodel/vmblu-cli 0.2.0 → 0.3.1

package/README.md

@@ -1,5 +1,5 @@
 # CLI for vmblu
-This folder contains the CLI commands that are available for vmblu. Currently there is only the 'init' and 'help' command, but others will follow.
+This folder contains the CLI commands that are available for vmblu.
 
 
 ## Folder layout
@@ -9,6 +9,7 @@ vmblu/
   cli/                      # your CLI source
     commands/
       init/
+      profile/
       migrate/
     templates/
       0.8.2/

package/commands/init/init-project.js

@@ -1,10 +1,10 @@
 // core/initProject.js
 // Node 18+ (fs/promises, crypto). No external deps.
-import * as fs from 'fs/promises';
-import * as fssync from 'fs';
-import path from 'path';
-//import crypto from 'crypto';
-import { makePackageJson } from './make-package-json.js';
+import * as fs from 'fs/promises';
+import * as fssync from 'fs';
+import path from 'path';
+//import crypto from 'crypto';
+import { makePackageJson } from './make-package-json.js';
 
 function rel(from, to) {
   return path.posix.join(...path.relative(from, to).split(path.sep));
@@ -73,14 +73,9 @@ function defaultModel(projectName) {
 function defaultDoc(projectName) {
   const now = new Date().toISOString();
   return JSON.stringify({
-    project: projectName,
-    generator: "vmblu-docgen",
-    generatorVersion: "0.0.0",
-    created: now,
-    files: [],
-    nodes: [],
-    pins: [],
-    handlers: []
+    version: "0.0.0",
+    generatedAt: now,
+    entries: {}
   }, null, 2);
 }
 
@@ -104,10 +99,10 @@ function fallbackSchema() {
 }`;
 }
 
-function fallbackSrcdocSchema() {
+function fallbackProfileSchema() {
   return `{
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "srcdoc.schema (placeholder)",
+  "title": "profile.schema (placeholder)",
   "type": "object",
   "description": "Placeholder schema. Replace with official version."
 }`;
@@ -119,16 +114,16 @@ function fallbackSeed() {
 vmblu (Vizual Model Blueprint) is a graphical editor that maintains a visual, runnable model of a software system.
 vmblu models software as interconnected nodes that pass messages via pins.  
 The model has a well defined format described by a schema. An additional annex gives semantic background information about the schema.
-The parameter profiles of messages and where in the actual source code messages are received and sent, is stored in a second file, the srcdoc file.
-The srcdoc file is generated automatically by vmblu and is only to be consulted, not written.
+The parameter profiles of messages and where in the actual source code messages are received and sent, is stored in a second file, the profile file.
+The profile file is generated automatically by vmblu and is only to be consulted, not written.
 
 You are an expert **architecture + code copilot** for **vmblu** .
-You can find the location of the model file, the model schema, the model annex, the srcdoc file and the srcdoc schema in the 'manifest.json' file of this project.
+You can find the location of the model file, the model schema, the model annex, the profile file and the profile schema in the 'manifest.json' file of this project.
 The location of all other files in the project can be found via the model file.
 
 Your job is to co-design the architecture and the software for the system.
 For modifications of the model, always follow the schema. 
-If the srcdoc does not contain profile information it could be that the code for a message has not been written yet, this should not stop you from continuing
+If the profile does not contain profile information it could be that the code for a message has not been written yet, this should not stop you from continuing
 `}
 
 /**
@@ -178,7 +173,7 @@ async function initProject(opts) {
   // Template sources
   const schemaSrc = path.join(templatesDir, schemaVersion, 'vmblu.schema.json');
   const annexSrc  = path.join(templatesDir, schemaVersion, 'vmblu.annex.md');
-  const srcdocSchemaSrc = path.join(templatesDir, schemaVersion, 'srcdoc.schema.json');
+  const profileSchemaSrc = path.join(templatesDir, schemaVersion, 'profile.schema.json');
   const seedSrc = path.join(templatesDir, schemaVersion, 'seed.md');
   
   // 1) Create folders
@@ -197,7 +192,7 @@ async function initProject(opts) {
   // 3) Copy schema + annex into llm/
   const schemaDst = path.join(llmDir, 'vmblu.schema.json');
   const annexDst  = path.join(llmDir, 'vmblu.annex.md');
-  const srcdocSchemaDst = path.join(llmDir, 'srcdoc.schema.json');
+  const profileSchemaDst = path.join(llmDir, 'profile.schema.json');
   const seedDst  = path.join(llmDir, 'seed.md');
 
 
@@ -207,8 +202,8 @@ async function initProject(opts) {
   ui.info(`copy ${annexSrc} -> ${annexDst}${force ? ' (force)' : ''}`);
   await copyOrWriteFallback(annexSrc, annexDst, fallbackAnnex(), { force, dry: dryRun });
 
-   ui.info(`copy ${srcdocSchemaSrc} -> ${srcdocSchemaDst}${force ? ' (force)' : ''}`);
-  await copyOrWriteFallback(srcdocSchemaSrc, srcdocSchemaDst, fallbackSrcdocSchema(), { force, dry: dryRun });
+   ui.info(`copy ${profileSchemaSrc} -> ${profileSchemaDst}${force ? ' (force)' : ''}`);
+  await copyOrWriteFallback(profileSchemaSrc, profileSchemaDst, fallbackProfileSchema(), { force, dry: dryRun });
 
   ui.info(`copy ${seedSrc} -> ${seedDst}${force ? ' (force)' : ''}`);
   await copyOrWriteFallback(seedSrc, seedDst, fallbackSeed(), { force, dry: dryRun });
@@ -235,9 +230,9 @@ async function initProject(opts) {
         schema: 'vmblu.schema.json',
         annex: 'vmblu.annex.md',
       },
-      srcdoc: { 
+      profile: { 
         path: rel(llmPosix, docFile), 
-        schema: 'srcdoc.schema.json',
+        schema: 'profile.schema.json',
       },
     };
 
@@ -251,7 +246,7 @@ async function initProject(opts) {
   }
 
   // 5) Make the package file
-  makePackageJson({ absTarget, projectName, force, dryRun, addCliDep: true, cliVersion: "^0.1.0" }, ui);
+  makePackageJson({ absTarget, projectName, force, dryRun, addCliDep: true, cliVersion: "^0.1.0" }, ui);
 
   // 6) Final tree hint
   ui.info(`\nScaffold complete${dryRun ? ' (dry run)' : ''}:\n` +
@@ -264,7 +259,7 @@ async function initProject(opts) {
       manifest.json
       vmblu.schema.json
       vmblu.annex.md
-      srcdoc.schema.json
+      profile.schema.json
       session/
     nodes/\n`);
 
@@ -277,7 +272,7 @@ async function initProject(opts) {
       doc: docFile,
       schema: schemaDst,
       annex: annexDst,
-      srdocSchema: srcdocSchemaDst,
+      profileSchema: profileSchemaDst,
       manifest: path.join(llmDir, 'manifest.json')
     },
     dryRun,
@@ -285,4 +280,4 @@ async function initProject(opts) {
   };
 }
 
-export { initProject };
+export { initProject };

package/commands/profile/index.js

@@ -1,4 +1,7 @@
-import { profile } from './profile.js';
+const bundleUrl = new URL('./profile.bundle.js', import.meta.url);
+const sourceUrl = new URL('./profile.js', import.meta.url);
+
+let profileModulePromise;
 
 export const command = 'profile <model-file>';
 export const describe = 'Find message handlers and message transmissions.';
@@ -9,8 +12,38 @@ export const builder = [
   { flag: '--changed <files...>', desc: 'only check changed files' },
   { flag: '--deleted <files...>', desc: 'remove data from deleted files' },
   { flag: '--delta-file <path>', desc: 'write the delta to a file' },
-  { flag: '--reason <text>', desc: 'information' },
+  { flag: '--reason <text>', desc: 'information' }
 ];
 
-export const handler = profile;
+export async function profile(argv) {
+  const mod = await getProfileModule();
+  if (typeof mod.profile !== 'function') {
+    throw new Error('Profile module does not export a runnable profile function.');
+  }
+  return mod.profile(argv);
+}
+
+export const handler = async (argv) => profile(argv);
+
+function getProfileModule() {
+  if (!profileModulePromise) {
+    profileModulePromise = loadProfileModule();
+  }
+  return profileModulePromise;
+}
+
+async function loadProfileModule() {
+  try {
+    return await import(bundleUrl);
+  } catch (err) {
+    if (isModuleNotFound(err)) {
+      return import(sourceUrl);
+    }
+    throw err;
+  }
+}
 
+function isModuleNotFound(err) {
+  const message = err?.message ?? '';
+  return err?.code === 'ERR_MODULE_NOT_FOUND' || message.includes('Cannot find module');
+}