visual-ai-staging 0.0.2 → 0.0.3

package/.github/workflows/publish.yml

@@ -10,6 +10,8 @@ on:
 jobs:
   publish:
     runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -17,7 +19,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Run Milestone 4 Unit Tests
@@ -26,6 +28,13 @@ jobs:
       - name: Run Milestone 5 Unit Tests
         run: node verify_r4.js
 
+      - name: Sync version with Git Tag
+        run: |
+          # Extract clean version number from tag (e.g., v0.0.2 -> 0.0.2)
+          CLEAN_VERSION=$(echo "${{ github.ref_name }}" | sed 's/^v//')
+          echo "Syncing package.json version to $CLEAN_VERSION"
+          npm version $CLEAN_VERSION --no-git-tag-version
+
       - name: Publish Package to NPM Registry
         run: npm publish
         env:

package/README.md

@@ -33,10 +33,26 @@ npm install -g visual-ai-staging
 ## Quick Start
 
 ### 1. Initialize the Staging Environment
-Navigate to your project root folder and start the native dev server:
+Navigate to your project root folder and initialize the workspace to create the local staging directories:
 
 ```bash
-# Start the Visual AI Staging local developer server
+# Prepare the Visual AI Staging local workspace
+vais init
+```
+
+*Console Output:*
+```bash
+Successfully initialized Visual AI Staging workspace!
+Created directories:
+  - .ai-staging/audio/
+  - .ai-staging/feedback/
+```
+
+### 2. Start the Development Server
+Launch the native local HTTP staging server:
+
+```bash
+# Start the local staging daemon
 vais dev
 ```
 
@@ -45,7 +61,7 @@ vais dev
 Visual AI Staging Dev Server running at http://localhost:3000/
 ```
 
-### 2. Run Visual Staging
+### 3. Run Visual Staging
 1. Open your web browser and navigate to `http://localhost:3000/`.
 2. Activate **Inspection Mode** or **Free-Zone Drawing** on the toolbar.
 3. Select elements, alter visual parameters, record voice notes, and staging your layout options.
@@ -64,6 +80,7 @@ Options:
   -h, --help     Output usage information
 
 Commands:
+  init           Initialize Visual AI Staging workspace (.ai-staging/ directories)
   dev            Start the Visual AI Staging native development server
 ```
 

package/cli.js

@@ -28,15 +28,64 @@ Options:
   -h, --help     Output usage information
 
 Commands:
+  init           Initialize Visual AI Staging workspace (.ai-staging/ directories)
   dev            Start the Visual AI Staging native development server
 `);
   process.exit(0);
 }
 
+if (command === 'init') {
+  const resolvedBase = path.resolve(__dirname);
+  const audioDir = path.join(resolvedBase, '.ai-staging', 'audio');
+  const feedbackDir = path.join(resolvedBase, '.ai-staging', 'feedback');
+  
+  try {
+    let alreadyExists = fs.existsSync(audioDir) && fs.existsSync(feedbackDir);
+    
+    fs.mkdirSync(audioDir, { recursive: true });
+    fs.mkdirSync(feedbackDir, { recursive: true });
+    
+    // Create .gitkeep to ensure empty directories are tracked by Git
+    const gitkeepAudio = path.join(audioDir, '.gitkeep');
+    const gitkeepFeedback = path.join(feedbackDir, '.gitkeep');
+    
+    if (!fs.existsSync(gitkeepAudio)) fs.writeFileSync(gitkeepAudio, '');
+    if (!fs.existsSync(gitkeepFeedback)) fs.writeFileSync(gitkeepFeedback, '');
+    
+    if (alreadyExists) {
+      console.log('Visual AI Staging environment already initialized in this workspace.');
+    } else {
+      console.log('Successfully initialized Visual AI Staging workspace!');
+      console.log('Created directories:');
+      console.log('  - .ai-staging/audio/');
+      console.log('  - .ai-staging/feedback/');
+    }
+  } catch (err) {
+    console.error('Error initializing workspace:', err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
 if (command === 'dev') {
   const port = 3000;
   const resolvedBase = path.resolve(__dirname);
 
+  // Auto-initialize directories silently on server startup if they do not exist
+  const audioDir = path.join(resolvedBase, '.ai-staging', 'audio');
+  const feedbackDir = path.join(resolvedBase, '.ai-staging', 'feedback');
+  try {
+    fs.mkdirSync(audioDir, { recursive: true });
+    fs.mkdirSync(feedbackDir, { recursive: true });
+    
+    const gitkeepAudio = path.join(audioDir, '.gitkeep');
+    const gitkeepFeedback = path.join(feedbackDir, '.gitkeep');
+    if (!fs.existsSync(gitkeepAudio)) fs.writeFileSync(gitkeepAudio, '');
+    if (!fs.existsSync(gitkeepFeedback)) fs.writeFileSync(gitkeepFeedback, '');
+  } catch (err) {
+    console.warn('Warning: Failed to auto-initialize staging directories on startup:', err.message);
+  }
+
   const server = http.createServer((req, res) => {
     const parsedUrl = url.parse(req.url, true);
     const pathname = parsedUrl.pathname;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "visual-ai-staging",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Visual AI Staging Companion — Bridge the gap between UI design staging and AI coding assistants.",
   "license": "MIT",
   "main": "app.js",
   "bin": {
     "vais": "./cli.js"
   }
-}
+}