stdio dbg 2 (#822)

- **add uuid dep**
- **add: writing an empty course for no-import static**
- **add helper info**

Author: NiloCK

dev.md

@@ -0,0 +1,12 @@
+# test db courseIDs
+
+2aeb8315ef78f3e89ca386992d00825b	Go (Programming Language)
+4a3bf3a147365a47ab8ab097b300028d	Ethereum
+641e9a99d9d21303c9a0b0fa24000b82	Linux Command Line
+787bc0d25821da0abb503a3b8b027f8d	JavaScript
+a9fae15687220aa6ce6201800502a3fd	TypeScript
+a9fae15687220aa6ce62018005040a8f	HTTP Status Codes
+a9fae15687220aa6ce62018005087c95	Emily
+e833171dd37e2945964962457700fb72	Word Work
+e92135c6c3ba6fba79367e7f26001ef3	Anatomy
+ed1d504ee2aa71872a7088db6c01fa6f	Piano (by ear)

packages/cli/src/utils/template.ts

@@ -1,8 +1,10 @@
 import { promises as fs, existsSync } from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { randomUUID } from 'crypto';
 import chalk from 'chalk';
 import { ProjectConfig, SkuilderConfig } from '../types.js';
+import { CourseConfig } from '@vue-skuilder/common';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -182,7 +184,8 @@ export default defineConfig({
  */
 export async function generateSkuilderConfig(
   configPath: string,
-  config: ProjectConfig
+  config: ProjectConfig,
+  outputPath?: string
 ): Promise<void> {
   const skuilderConfig: SkuilderConfig = {
     title: config.title,
@@ -194,13 +197,14 @@ export async function generateSkuilderConfig(
     skuilderConfig.course = config.course;
   }
 
-  // For static data layer with imported courses, use the first course as primary
-  if (
-    config.dataLayerType === 'static' &&
-    config.importCourseIds &&
-    config.importCourseIds.length > 0
-  ) {
-    skuilderConfig.course = config.importCourseIds[0];
+  // For static data layer, use imported course ID or generate new one
+  if (config.dataLayerType === 'static') {
+    if (config.importCourseIds && config.importCourseIds.length > 0) {
+      skuilderConfig.course = config.importCourseIds[0];
+    } else {
+      // Generate UUID for new static courses without imports
+      skuilderConfig.course = randomUUID();
+    }
   }
 
   if (config.couchdbUrl) {
@@ -212,6 +216,11 @@ export async function generateSkuilderConfig(
   }
 
   await fs.writeFile(configPath, JSON.stringify(skuilderConfig, null, 2));
+
+  // For static data layer without imports, create empty course structure
+  if (config.dataLayerType === 'static' && (!config.importCourseIds || config.importCourseIds.length === 0) && outputPath) {
+    await createEmptyCourseStructure(outputPath, skuilderConfig.course!, config.title);
+  }
 }
 
 /**
@@ -250,6 +259,72 @@ export async function transformTsConfig(tsconfigPath: string): Promise<void> {
   await fs.writeFile(tsconfigPath, JSON.stringify(tsconfig, null, 2));
 }
 
+/**
+ * Create empty course structure for new static courses
+ */
+async function createEmptyCourseStructure(
+  projectPath: string,
+  courseId: string,
+  title: string
+): Promise<void> {
+  const staticCoursesPath = path.join(projectPath, 'public', 'static-courses');
+  const coursePath = path.join(staticCoursesPath, courseId);
+  
+  // Create directory structure
+  await fs.mkdir(coursePath, { recursive: true });
+  await fs.mkdir(path.join(coursePath, 'chunks'), { recursive: true });
+  await fs.mkdir(path.join(coursePath, 'indices'), { recursive: true });
+  
+  // Create minimal CourseConfig
+  const courseConfig: CourseConfig = {
+    courseID: courseId,
+    name: title,
+    description: '',
+    public: false,
+    deleted: false,
+    creator: 'system',
+    admins: [],
+    moderators: [],
+    dataShapes: [],
+    questionTypes: []
+  };
+  
+  // Create manifest.json with proper structure
+  const manifest = {
+    version: '1.0.0',
+    courseId,
+    courseName: title,
+    courseConfig,
+    lastUpdated: new Date().toISOString(),
+    documentCount: 0,
+    chunks: [],
+    indices: [],
+    designDocs: []
+  };
+  
+  await fs.writeFile(
+    path.join(coursePath, 'manifest.json'),
+    JSON.stringify(manifest, null, 2)
+  );
+  
+  // Create empty tags index
+  await fs.writeFile(
+    path.join(coursePath, 'indices', 'tags.json'),
+    JSON.stringify({ tags: [] }, null, 2)
+  );
+  
+  // Create CourseConfig chunk
+  await fs.writeFile(
+    path.join(coursePath, 'chunks', 'CourseConfig.json'),
+    JSON.stringify([{
+      _id: 'CourseConfig',
+      ...courseConfig
+    }], null, 2)
+  );
+  
+  console.log(chalk.green(`✅ Created empty course structure for ${courseId}`));
+}
+
 /**
  * Generate .gitignore file for the project
  */
@@ -540,7 +615,7 @@ export async function processTemplate(
 
   console.log(chalk.blue('🔧 Generating configuration...'));
   const configPath = path.join(projectPath, 'skuilder.config.json');
-  await generateSkuilderConfig(configPath, config);
+  await generateSkuilderConfig(configPath, config, projectPath);
 
   console.log(chalk.blue('📝 Creating README...'));
   const readmePath = path.join(projectPath, 'README.md');

packages/db/package.json

@@ -48,7 +48,8 @@
         "@vue-skuilder/common": "workspace:*",
         "moment": "^2.29.4",
         "pouchdb": "^9.0.0",
-        "pouchdb-find": "^9.0.0"
+        "pouchdb-find": "^9.0.0",
+        "uuid": "^11.1.0"
     },
     "devDependencies": {
         "@types/uuid": "^10.0.0",

yarn.lock

@@ -5400,6 +5400,7 @@ __metadata:
     pouchdb-find: "npm:^9.0.0"
     tsup: "npm:^8.0.2"
     typescript: "npm:~5.7.2"
+    uuid: "npm:^11.1.0"
   languageName: unknown
   linkType: soft
 
@@ -16425,6 +16426,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"uuid@npm:^11.1.0":
+  version: 11.1.0
+  resolution: "uuid@npm:11.1.0"
+  bin:
+    uuid: dist/esm/bin/uuid
+  checksum: 10c0/34aa51b9874ae398c2b799c88a127701408cd581ee89ec3baa53509dd8728cbb25826f2a038f9465f8b7be446f0fbf11558862965b18d21c993684297628d4d3
+  languageName: node
+  linkType: hard
+
 "v8-compile-cache-lib@npm:^3.0.1":
   version: 3.0.1
   resolution: "v8-compile-cache-lib@npm:3.0.1"