coursecode 0.1.55 → 0.1.57

package/README.md

@@ -235,7 +235,7 @@ coursecode preview --export
 
 | Command | Description |
 |---------|-------------|
-| `coursecode create <name>` | Create a new course project; use `.` to initialize the current directory |
+| `coursecode create <name>` | Create a new course project; `create .` derives a title-cased course title and hyphenated npm name from the current folder |
 | `coursecode init [name]` | Initialize the current directory, optionally with a course title |
 | `coursecode preview` | Preview your course locally |
 | `coursecode convert` | Convert PDFs, Word, PowerPoint to markdown |

package/bin/cli.js

@@ -97,7 +97,7 @@ program
   .option('--start', 'Auto-start dev server after creation (skip prompt)')
   .action(async (name, options) => {
     const { create } = await import('../lib/create.js');
-    await create(name || path.basename(process.cwd()), { ...options, currentDirectory: true });
+    await create(name || '.', { ...options, currentDirectory: true });
   });
 
 // Dev command

package/framework/docs/COURSE_AUTHORING_GUIDE.md

@@ -16,7 +16,7 @@
 |---------|-------------|
 | `coursecode create <name>` | Create a new course project (includes example slides) |
 | `coursecode create <name> --blank` | Create a blank project (no example content) |
-| `coursecode create .` | Initialize the current directory using its folder name as the course title |
+| `coursecode create .` | Initialize the current directory; `client-manager-course` becomes title `Client Manager Course` and package name `client-manager-course` |
 | `coursecode init [name]` | Initialize the current directory, optionally with a specific course title |
 | `coursecode clean` | Remove example files and reset config to minimal starter |
 | `coursecode new slide <id>` | Create a new slide file in `course/slides/` |

package/framework/version.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.55",
+  "version": "0.1.57",
   "name": "CourseCode Framework",
   "description": "Multi-format course authoring and learner runtime framework",
   "released": "2026-07-11",

package/lib/build-packaging.js

@@ -9,7 +9,7 @@
 
 import fs from 'fs';
 import path from 'path';
-import archiver from 'archiver';
+import { ZipArchive } from 'archiver';
 import { fileURLToPath } from 'url';
 import { generateManifest } from './manifest/manifest-factory.js';
 
@@ -35,7 +35,7 @@ function withClientCredentials(externalUrl, clientId, token) {
 function zipDirectory(sourceDir, zipFilePath) {
     return new Promise((resolve, reject) => {
         const output = fs.createWriteStream(zipFilePath);
-        const archive = archiver('zip', { zlib: { level: 9 } });
+        const archive = new ZipArchive({ zlib: { level: 9 } });
 
         output.on('close', () => resolve(archive.pointer()));
         archive.on('error', reject);

package/lib/create.js

@@ -9,6 +9,16 @@ import { spawn } from 'child_process';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = path.join(__dirname, '..');
+const REQUIRED_PROJECT_DIRECTORIES = [
+  {
+    path: path.join('course', 'references'),
+    placeholder: '# Place source documents here (docx, pptx, pdf)\n# Run `coursecode convert` to convert them to markdown\n'
+  },
+  {
+    path: path.join('course', 'references', 'converted'),
+    placeholder: '# Converted markdown files will be placed here\n# These can be used as source material for AI-assisted course creation\n'
+  }
+];
 
 export function toProjectDirectoryName(name) {
   return String(name || '')
@@ -21,6 +31,32 @@ export function toProjectDirectoryName(name) {
     .replace(/^_+|_+$/g, '');
 }
 
+function directoryNameWords(name) {
+  return String(name || '')
+    .trim()
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+    .replace(/['’]/g, '')
+    .replace(/[^a-zA-Z0-9]+/g, ' ')
+    .trim()
+    .split(/\s+/)
+    .filter(Boolean);
+}
+
+export function toCurrentDirectoryCourseTitle(name) {
+  return directoryNameWords(name)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join(' ');
+}
+
+export function toCurrentDirectoryPackageName(name) {
+  return directoryNameWords(name)
+    .map(word => word.toLowerCase())
+    .join('-');
+}
+
 function escapeSingleQuotedValue(value) {
   return String(value).replace(/\\/g, '\\\\').replace(/'/g, "\\'");
 }
@@ -77,6 +113,18 @@ function copyDir(src, dest, options = {}) {
   }
 }
 
+function ensureRequiredProjectDirectories(projectDir) {
+  for (const directory of REQUIRED_PROJECT_DIRECTORIES) {
+    const directoryPath = path.join(projectDir, directory.path);
+    const placeholderPath = path.join(directoryPath, '.gitkeep');
+    fs.mkdirSync(directoryPath, { recursive: true });
+
+    if (!fs.existsSync(placeholderPath)) {
+      fs.writeFileSync(placeholderPath, directory.placeholder, 'utf-8');
+    }
+  }
+}
+
 function mergeProjectControlFile(sourcePath, destinationPath) {
   const source = fs.readFileSync(sourcePath, 'utf-8').trimEnd();
   if (!fs.existsSync(destinationPath)) {
@@ -161,9 +209,14 @@ function gitInit(cwd) {
 export async function create(name, options = {}) {
   const requestedName = String(name || '').trim();
   const currentDirectory = options.currentDirectory === true || requestedName === '.';
-  const inferredName = path.basename(process.cwd()).replace(/[-_]+/g, ' ');
-  const displayName = currentDirectory && requestedName === '.' ? inferredName : requestedName;
-  const directoryName = toProjectDirectoryName(displayName);
+  const inferFromCurrentDirectory = currentDirectory && requestedName === '.';
+  const currentDirectoryName = path.basename(process.cwd());
+  const displayName = inferFromCurrentDirectory
+    ? toCurrentDirectoryCourseTitle(currentDirectoryName)
+    : requestedName;
+  const directoryName = inferFromCurrentDirectory
+    ? toCurrentDirectoryPackageName(currentDirectoryName)
+    : toProjectDirectoryName(displayName);
 
   if (!displayName) {
     console.error('\n❌ Course name is required.\n');
@@ -200,6 +253,7 @@ export async function create(name, options = {}) {
   });
   mergeProjectControlFile(path.join(templateDir, 'gitignore'), path.join(targetDir, '.gitignore'));
   mergeProjectControlFile(path.join(templateDir, 'gitattributes'), path.join(targetDir, '.gitattributes'));
+  ensureRequiredProjectDirectories(targetDir);
 
   // Copy framework
   const frameworkSrc = path.join(PACKAGE_ROOT, 'framework');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coursecode",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "Multi-format course authoring framework with CLI tools (SCORM 2004, SCORM 1.2, cmi5, LTI 1.3)",
   "type": "module",
   "bin": {
@@ -104,7 +104,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "acorn": "^8.17.0",
-    "archiver": "^7.0.1",
+    "archiver": "^8.0.0",
     "commander": "^14.0.3",
     "lz-string": "^1.5.0",
     "mammoth": "^1.12.0",

package/template/package.json

@@ -21,7 +21,7 @@
     "marked-gfm-heading-id": "^4.1.4"
   },
   "devDependencies": {
-    "archiver": "^7.0.1",
+    "archiver": "^8.0.0",
     "eslint": "^9.39.4",
     "vite": "~8.1.4",
     "vite-plugin-static-copy": "^4.1.1"