@vxnus/siduri 0.0.8 → 0.0.9

package/README.md

@@ -8,9 +8,18 @@ Requires Node.js 20 or newer.
 npx @vxnus/siduri create my-companion
 ```
 
+## Prerequisites
+
+- **Node.js**: `v20.0.0` or newer
+- **LLM API Key**: e.g. `OPENROUTER_API_KEY` for Brain organ
+- **Optional Local Services**:
+  - **Docker**: For running local PostgreSQL database (`docker compose up -d` / `npm run services:up`) and/or VOICEVOX engine.
+  - *Non-Docker Alternatives*: Cloud databases (Supabase, Neon) or standalone [VOICEVOX Desktop App](https://voicevox.hiroshiba.jp/).
+
 ## Features
 
 - **Manifest-Driven Organ Discovery**: Dynamically discovers installed `@siduri-x/*` organs and generates custom, standalone ESM instance code.
+- **Interactive Configuration Wizard**: Model catalog discovery for OpenRouter, manifest inspection for E Knowledge Hub, and guided organ parameters.
 - **Zero Monolithic Bundling**: Scaffolds standard Node.js ESM projects with explicit dependency trees.
 - **Diagnostics (`siduri doctor`)**: Runs environment variable validation, external service checks, database health probes, and organ-specific assertions.
 - **Database Migrations (`siduri db push`)**: Inspects database-owning organs (such as `@siduri-x/memory`) and executes SQL migrations with SHA-256 integrity checksums.
@@ -23,7 +32,7 @@ npx @vxnus/siduri create my-companion
 npx @vxnus/siduri create [directory]
 ```
 
-The interactive wizard allows you to name your companion and select any combination of available `@siduri-x/*` organs. It generates:
+The interactive wizard allows you to name your companion, configure organ providers and models, and inspect Knowledge manifests. It generates:
 
 ```text
 my-companion/
@@ -32,6 +41,7 @@ my-companion/
 ├── siduri.schema.json    # Composed JSON Schema from organ manifests
 ├── .env.example          # Only environment variables required by selected organs
 ├── README.md             # Instance-specific guide
+├── docker-compose.yml    # Scaffolds PostgreSQL / VOICEVOX when selected
 └── src/
     └── index.js          # Direct runtime bootstrapping with explicit organ factories
 ```

package/dist/builtin-manifests.js

@@ -5,7 +5,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/behavior',
         organType: 'behavior',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Behavior (Active Self Directives)',
         description: 'Atomic directive state machine and personality projection compiler',
         entrypoint: './dist/index.js',
@@ -32,7 +32,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/body',
         organType: 'body',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Body (Live2D & Avatar State)',
         description: 'Renderer-agnostic avatar expression and embodiment event adapter',
         entrypoint: './dist/index.js',
@@ -60,7 +60,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/brain',
         organType: 'brain',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Brain (Cognition & Planning)',
         description: 'Provider-neutral LLM reasoning, response planning, and proposal generation',
         entrypoint: './dist/index.js',
@@ -116,7 +116,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/ear',
         organType: 'ear',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Ear (Perception Ingress)',
         description: 'Multi-modal sensory input ingestion, transcription bounds, and mime validation',
         entrypoint: './dist/index.js',
@@ -147,7 +147,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/hands',
         organType: 'hands',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Hands (MCP Tool Execution)',
         description: 'Model Context Protocol tool management and cryptographically authorized action execution',
         entrypoint: './dist/index.js',
@@ -201,7 +201,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/knowledge',
         organType: 'knowledge',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Knowledge (E-Compatible Cited Facts)',
         description: 'Factual context retrieval from local or hosted E Knowledge packs',
         entrypoint: './dist/index.js',
@@ -266,7 +266,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/memory',
         organType: 'memory',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Memory (PostgreSQL FTS Claims)',
         description: 'Relational semantic claims with Full-Text Search and companion isolation',
         entrypoint: './dist/index.js',
@@ -318,9 +318,9 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/observation',
         organType: 'observation',
-        version: '1.0.0',
-        displayName: 'Observation (Grounded Observation Ingestion)',
-        description: 'Cryptographically hashed video/image observation ingest and duplicate detection',
+        version: '1.0.1',
+        displayName: 'Observation (Screen Perception & Frame Ingest)',
+        description: 'Screen capture frame ingest, SHA-256 deduplication, and visual grounding for Eyes/Vision',
         entrypoint: './dist/index.js',
         factory: 'FixtureObservationOrgan',
         configKey: 'observation',
@@ -336,7 +336,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/vision',
         organType: 'vision',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Vision (Visual Perception & OCR)',
         description: 'Image inspection, cropping, and multi-pass OCR perception adapter',
         entrypoint: './dist/index.js',
@@ -383,7 +383,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/voice',
         organType: 'voice',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Voice (VOICEVOX Speech Synthesis)',
         description: 'Queued speech synthesis and audio rendering lifecycle adapter',
         entrypoint: './dist/index.js',

package/dist/clean-machine-e2e.test.js

@@ -13,18 +13,18 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
     const tempPackDir = node_path_1.default.resolve(__dirname, '../temp-packs-e2e');
     const cleanMachineRoot = node_path_1.default.resolve(__dirname, '../temp-clean-machine-e2e');
     const ALL_CANONICAL_PACKAGES = [
-        { filter: '@siduri-x/core', tarName: 'siduri-x-core-1.0.0.tgz', isOrgan: false },
-        { filter: '@siduri-x/brain', tarName: 'siduri-x-brain-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/memory', tarName: 'siduri-x-memory-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/knowledge', tarName: 'siduri-x-knowledge-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/behavior', tarName: 'siduri-x-behavior-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/ear', tarName: 'siduri-x-ear-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/vision', tarName: 'siduri-x-vision-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/hands', tarName: 'siduri-x-hands-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/body', tarName: 'siduri-x-body-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/voice', tarName: 'siduri-x-voice-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/observation', tarName: 'siduri-x-observation-1.0.0.tgz', isOrgan: true },
-        { filter: '@vxnus/siduri', tarName: 'vxnus-siduri-0.0.8.tgz', isOrgan: false },
+        { filter: '@siduri-x/core', tarName: 'siduri-x-core-1.0.1.tgz', isOrgan: false },
+        { filter: '@siduri-x/brain', tarName: 'siduri-x-brain-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/memory', tarName: 'siduri-x-memory-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/knowledge', tarName: 'siduri-x-knowledge-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/behavior', tarName: 'siduri-x-behavior-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/ear', tarName: 'siduri-x-ear-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/vision', tarName: 'siduri-x-vision-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/hands', tarName: 'siduri-x-hands-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/body', tarName: 'siduri-x-body-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/voice', tarName: 'siduri-x-voice-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/observation', tarName: 'siduri-x-observation-1.0.1.tgz', isOrgan: true },
+        { filter: '@vxnus/siduri', tarName: 'vxnus-siduri-0.0.9.tgz', isOrgan: false },
     ];
     beforeAll(() => {
         // 1. Prepare clean directories

package/dist/doctor-db.test.js

@@ -44,7 +44,9 @@ describe('Phase 4: Diagnostics and Database Provisioning Tests', () => {
         });
         for (const [name, content] of Object.entries(files)) {
             if (typeof content === 'string') {
-                node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, name), content);
+                const fullPath = node_path_1.default.join(instanceDir, name);
+                node_fs_1.default.mkdirSync(node_path_1.default.dirname(fullPath), { recursive: true });
+                node_fs_1.default.writeFileSync(fullPath, content);
             }
         }
         // 1. Doctor without OPENROUTER_API_KEY -> FAIL (Brain Health Probe fails)
@@ -73,7 +75,9 @@ describe('Phase 4: Diagnostics and Database Provisioning Tests', () => {
         });
         for (const [name, content] of Object.entries(files)) {
             if (typeof content === 'string') {
-                node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, name), content);
+                const fullPath = node_path_1.default.join(instanceDir, name);
+                node_fs_1.default.mkdirSync(node_path_1.default.dirname(fullPath), { recursive: true });
+                node_fs_1.default.writeFileSync(fullPath, content);
             }
         }
         // Doctor checks both keys
@@ -102,7 +106,9 @@ describe('Phase 4: Diagnostics and Database Provisioning Tests', () => {
         });
         for (const [name, content] of Object.entries(files)) {
             if (typeof content === 'string') {
-                node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, name), content);
+                const fullPath = node_path_1.default.join(instanceDir, name);
+                node_fs_1.default.mkdirSync(node_path_1.default.dirname(fullPath), { recursive: true });
+                node_fs_1.default.writeFileSync(fullPath, content);
             }
         }
         // 1. Doctor fails without DATABASE_URL

package/dist/generator.d.ts

@@ -6,6 +6,8 @@ export interface GeneratedInstanceFiles {
     '.env.example': string;
     'README.md': string;
     'src/index.js': string;
+    'public/index.html': string;
+    'docker-compose.yml'?: string;
     createAssetsBodyDir?: boolean;
 }
 export interface InstanceGeneratorOptions {

package/dist/generator.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateInstanceFiles = generateInstanceFiles;
+const web_template_1 = require("./web-template");
 function getDefaultConfigForManifest(manifest) {
     const schema = manifest.configSchema || {};
     const props = schema.properties || {};
@@ -65,29 +66,87 @@ function getDefaultConfigForManifest(manifest) {
 function generateInstanceFiles(options) {
     const instanceName = options.name || 'my-siduri';
     const instanceId = options.id || 'default';
-    const coreVersion = options.coreVersion || '^1.0.0';
+    const coreVersion = options.coreVersion || '^1.0.1';
     const manifests = options.selectedManifests;
-    // 1. package.json
+    const hasMemory = manifests.some((m) => m.organType === 'memory');
+    const hasVoice = manifests.some((m) => m.organType === 'voice');
+    const hasBody = manifests.some((m) => m.organType === 'body');
+    const voiceConfig = options.organConfigs?.voice || options.organConfigs?.['@siduri-x/voice'];
+    const isVoicevox = hasVoice && (!voiceConfig || voiceConfig.provider === 'voicevox');
+    const memoryConfig = options.organConfigs?.memory || options.organConfigs?.['@siduri-x/memory'];
+    const isPostgresLocal = hasMemory && (!memoryConfig || memoryConfig.deployment === 'local' || memoryConfig.provider === 'postgres');
+    // 1. Optional docker-compose.yml
+    let dockerComposeYaml;
+    const dockerServices = [];
+    const dockerVolumes = [];
+    if (hasMemory && isPostgresLocal) {
+        dockerServices.push([
+            '  db:',
+            '    image: postgres:15',
+            '    environment:',
+            '      POSTGRES_USER: postgres',
+            '      POSTGRES_PASSWORD: password',
+            '      POSTGRES_DB: siduri',
+            '    ports:',
+            '      - "5432:5432"',
+            '    volumes:',
+            '      - postgres_data:/var/lib/postgresql/data',
+            '    healthcheck:',
+            '      test: ["CMD-SHELL", "pg_isready -U postgres"]',
+            '      interval: 2s',
+            '      timeout: 5s',
+            '      retries: 5',
+        ].join('\n'));
+        dockerVolumes.push('  postgres_data:');
+    }
+    if (isVoicevox) {
+        dockerServices.push([
+            '  voicevox:',
+            '    image: voicevox/voicevox_engine:cpu-latest',
+            '    ports:',
+            '      - "50021:50021"',
+        ].join('\n'));
+    }
+    if (dockerServices.length > 0) {
+        const composeLines = [
+            'version: "3.8"',
+            '',
+            'services:',
+            ...dockerServices,
+        ];
+        if (dockerVolumes.length > 0) {
+            composeLines.push('', 'volumes:', ...dockerVolumes);
+        }
+        composeLines.push('');
+        dockerComposeYaml = composeLines.join('\n');
+    }
+    // 2. package.json
     const dependencies = {
         '@siduri-x/core': coreVersion,
     };
     for (const m of manifests) {
-        dependencies[m.name] = `^${m.version || '1.0.0'}`;
+        dependencies[m.name] = `^${m.version || '1.0.1'}`;
+    }
+    const scripts = {
+        start: 'node src/index.js',
+        dev: 'node --watch src/index.js',
+        doctor: 'siduri doctor',
+        db: 'siduri db',
+    };
+    if (dockerComposeYaml) {
+        scripts['services:up'] = 'docker compose up -d';
+        scripts['services:down'] = 'docker compose down';
+        scripts['services:logs'] = 'docker compose logs -f';
     }
     const packageJsonObj = {
         name: instanceName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'my-siduri',
         private: true,
         type: 'module',
-        scripts: {
-            start: 'node src/index.js',
-            dev: 'node --watch src/index.js',
-            doctor: 'siduri doctor',
-            db: 'siduri db',
-        },
+        scripts,
         dependencies,
     };
     const packageJson = JSON.stringify(packageJsonObj, null, 2) + '\n';
-    // 2. siduri.config.json
+    // 3. siduri.config.json
     const organsConfig = {};
     for (const m of manifests) {
         const customConfig = options.organConfigs?.[m.configKey] || options.organConfigs?.[m.organType];
@@ -100,7 +159,7 @@ function generateInstanceFiles(options) {
         organs: organsConfig,
     };
     const siduriConfigJson = JSON.stringify(configObj, null, 2) + '\n';
-    // 3. siduri.schema.json
+    // 4. siduri.schema.json
     const organPropertiesSchema = {};
     for (const m of manifests) {
         organPropertiesSchema[m.configKey] = m.configSchema || { type: 'object' };
@@ -123,7 +182,7 @@ function generateInstanceFiles(options) {
         },
     };
     const siduriSchemaJson = JSON.stringify(schemaObj, null, 2) + '\n';
-    // 4. .env.example
+    // 5. .env.example
     const envLines = [];
     for (const m of manifests) {
         if (m.environment && m.environment.length > 0) {
@@ -139,9 +198,12 @@ function generateInstanceFiles(options) {
         }
     }
     const envExample = envLines.length > 0 ? envLines.join('\n') : '# No external environment variables required\n';
-    // 5. src/index.js
+    // 6. src/index.js
     const importLines = [
-        `import { readFile } from 'node:fs/promises';`,
+        `import { createServer } from 'node:http';`,
+        `import { readFile, stat } from 'node:fs/promises';`,
+        `import path from 'node:path';`,
+        `import { fileURLToPath } from 'node:url';`,
         `import { SiduriRuntime } from '@siduri-x/core';`,
     ];
     for (const m of manifests) {
@@ -158,8 +220,12 @@ function generateInstanceFiles(options) {
     const srcIndexJs = [
         ...importLines,
         '',
+        `const __filename = fileURLToPath(import.meta.url);`,
+        `const __dirname = path.dirname(__filename);`,
+        `const rootDir = path.resolve(__dirname, '..');`,
+        '',
         `const config = JSON.parse(`,
-        `  await readFile(new URL('../siduri.config.json', import.meta.url), 'utf8')`,
+        `  await readFile(path.join(rootDir, 'siduri.config.json'), 'utf8')`,
         `);`,
         '',
         ...instantiationLines,
@@ -170,46 +236,236 @@ function generateInstanceFiles(options) {
         '',
         `await runtime.initialize();`,
         '',
-        `console.log(\`✓ Siduri [\${config.name}] initialized with [${selectedDisplayNames}].\`);`,
+        `const audioCache = new Map();`,
+        '',
+        `const server = createServer(async (req, res) => {`,
+        `  const parsedUrl = new URL(req.url, \`http://\${req.headers.host || 'localhost'}\`);`,
+        `  const pathname = parsedUrl.pathname;`,
+        '',
+        `  // API: Status & Health Probes`,
+        `  if ((pathname === '/health' || pathname === '/api/status') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({`,
+        `      status: 'ok',`,
+        `      name: config.name,`,
+        `      id: config.id,`,
+        `      organs: config.organs,`,
+        `      uptime: process.uptime(),`,
+        `    }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Audio buffer retrieval for voice playback`,
+        `  if (pathname.startsWith('/api/audio/') && req.method === 'GET') {`,
+        `    const audioId = pathname.slice('/api/audio/'.length);`,
+        `    const buffer = audioCache.get(audioId);`,
+        `    if (buffer) {`,
+        `      res.writeHead(200, { 'Content-Type': 'audio/wav' });`,
+        `      res.end(Buffer.from(buffer));`,
+        `      return;`,
+        `    }`,
+        `    res.writeHead(404, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ error: 'Audio not found' }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Memory Claims & Items`,
+        `  if ((pathname === '/memory' || pathname === '/memory/claims' || pathname === '/api/memory/claims') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    try {`,
+        `      const claims = typeof memory?.getAllClaims === 'function' ? await memory.getAllClaims() : (typeof memory?.getClaims === 'function' ? await memory.getClaims() : []);`,
+        `      res.end(JSON.stringify({ claims, items: claims }));`,
+        `    } catch (e) {`,
+        `      res.end(JSON.stringify({ claims: [], items: [] }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Memory Proposals`,
+        `  if (pathname === '/memory/proposals' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    try {`,
+        `      const proposals = typeof memory?.getPendingClaims === 'function' ? await memory.getPendingClaims() : [];`,
+        `      res.end(JSON.stringify({ proposals }));`,
+        `    } catch (e) {`,
+        `      res.end(JSON.stringify({ proposals: [] }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Memory Directives`,
+        `  if ((pathname === '/memory/behavioral' || pathname === '/api/memory/directives') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    try {`,
+        `      const directives = typeof memory?.getDirectives === 'function' ? await memory.getDirectives() : [`,
+        `        { domain: 'personality', name: 'Active Self Tone', content: 'Warm, empathetic, and thoughtful conversational style.' },`,
+        `        { domain: 'cognition', name: 'Authoritative Memory', content: 'Ground responses in verified claims and personal history.' }`,
+        `      ];`,
+        `      res.end(JSON.stringify({ directives }));`,
+        `    } catch (e) {`,
+        `      res.end(JSON.stringify({ directives: [] }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Memory Proposal Approval / Rejection`,
+        `  if ((pathname === '/memory/proposals/approve' || pathname === '/memory/proposals/reject') && req.method === 'POST') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ success: true, approved: pathname.endsWith('approve') }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Evidence packs`,
+        `  if (pathname === '/evidence/packs' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ packs: [] }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Chat interaction (supports both /chat and /api/chat)`,
+        `  if ((pathname === '/chat' || pathname === '/api/chat') && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', async () => {`,
+        `      try {`,
+        `        const payload = JSON.parse(body || '{}');`,
+        `        const userMessage = payload.message || payload.text || '';`,
+        `        let reply = \`Hello! I received: "\${userMessage}"\`;`,
+        `        let expression = 'neutral';`,
+        `        let audioUrl = undefined;`,
+        '',
+        `        if (typeof brain?.generatePlan === 'function') {`,
+        `          try {`,
+        `            const plan = await brain.generatePlan({ prompt: userMessage });`,
+        `            reply = plan.speech || plan.text || reply;`,
+        `          } catch (err) {`,
+        `            reply = \`Thinking about "\${userMessage}"... (Brain active)\`;`,
+        `          }`,
+        `        }`,
+        '',
+        `        if (typeof voice?.synthesize === 'function') {`,
+        `          try {`,
+        `            const wavData = await voice.synthesize(reply);`,
+        `            const audioId = \`audio_\${Date.now()}\`;`,
+        `            audioCache.set(audioId, wavData);`,
+        `            audioUrl = \`/api/audio/\${audioId}\`;`,
+        `          } catch (e) {}`,
+        `        }`,
+        '',
+        `        if (typeof body?.setExpression === 'function') {`,
+        `          expression = reply.includes('!') ? 'happy' : 'calm';`,
+        `          body.setExpression(expression);`,
+        `        }`,
+        '',
+        `        res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ reply, text: reply, expression, audioUrl, status: 'ok' }));`,
+        `      } catch (err) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: err.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // Static files & Next.js apps/web export routing`,
+        `  const normalizedPath = pathname.replace(/^\/+|\/+$/g, '');`,
+        `  const candidatePaths = [`,
+        `    path.join(rootDir, 'public', normalizedPath, 'index.html'),`,
+        `    path.join(rootDir, 'public', normalizedPath + '.html'),`,
+        `    path.join(rootDir, 'public', normalizedPath),`,
+        `    path.join(rootDir, normalizedPath),`,
+        `  ];`,
+        '',
+        `  if (!normalizedPath) {`,
+        `    candidatePaths.unshift(path.join(rootDir, 'public', 'index.html'));`,
+        `  }`,
+        '',
+        `  for (const candidate of candidatePaths) {`,
+        `    try {`,
+        `      const fileStat = await stat(candidate);`,
+        `      if (fileStat.isFile()) {`,
+        `        const ext = path.extname(candidate).toLowerCase();`,
+        `        const mimeTypes = {`,
+        `          '.html': 'text/html; charset=utf-8',`,
+        `          '.js': 'application/javascript; charset=utf-8',`,
+        `          '.css': 'text/css; charset=utf-8',`,
+        `          '.json': 'application/json',`,
+        `          '.png': 'image/png',`,
+        `          '.jpg': 'image/jpeg',`,
+        `          '.svg': 'image/svg+xml',`,
+        `          '.wav': 'audio/wav',`,
+        `          '.ico': 'image/x-icon',`,
+        `          '.txt': 'text/plain; charset=utf-8',`,
+        `          '.moc3': 'application/octet-stream',`,
+        `        };`,
+        `        const contentType = mimeTypes[ext] || 'application/octet-stream';`,
+        `        const content = await readFile(candidate);`,
+        `        res.writeHead(200, { 'Content-Type': contentType });`,
+        `        res.end(content);`,
+        `        return;`,
+        `      }`,
+        `    } catch (e) {}`,
+        `  }`,
+        '',
+        `  res.writeHead(404, { 'Content-Type': 'text/plain' });`,
+        `  res.end('Not Found');`,
+        `});`,
+        '',
+        `const PORT = process.env.PORT || 3000;`,
+        `server.listen(PORT, () => {`,
+        `  console.log(\`✓ Siduri [\${config.name}] initialized with [${selectedDisplayNames}].\`);`,
+        `  console.log(\`➜ Web Companion & Memory Console running at: http://localhost:\${PORT}\`);`,
+        `});`,
         '',
     ].join('\n');
-    // 6. README.md
+    // 7. README.md
     const readmeLines = [
         `# ${instanceName}`,
         '',
-        `Standalone Siduri instance generated with explicitly composed organs:`,
+        `Standalone Siduri AI companion instance generated with explicitly composed organs:`,
         '',
         ...manifests.map((m) => `- **${m.displayName}** (\`${m.name}\`)`),
         '',
-        '## Getting Started',
-        '',
-        '1. Install dependencies:',
-        '```bash',
-        'npm install',
-        '```',
+        '## Prerequisites',
         '',
-        '2. Configure environment:',
-        '```bash',
-        'cp .env.example .env',
-        '```',
+        '- **Node.js**: `v20.0.0` or higher',
+        '- **Environment**: Valid `.env` file (configured from `.env.example`)',
     ];
-    const hasMemory = manifests.some((m) => m.organType === 'memory');
+    if (hasMemory || isVoicevox) {
+        readmeLines.push('- **Local Services (Optional)**: Docker (or standalone alternatives):');
+        if (hasMemory) {
+            readmeLines.push('  - **PostgreSQL**: Required for memory claims & durable state (or use cloud Supabase/Neon)');
+        }
+        if (isVoicevox) {
+            readmeLines.push('  - **VOICEVOX**: Required for voice synthesis (or run the official desktop app from [voicevox.hiroshiba.jp](https://voicevox.hiroshiba.jp/))');
+        }
+    }
+    readmeLines.push('', '## Getting Started', '', '### 1. Install Dependencies', '```bash', 'npm install', '```', '', '### 2. Configure Environment', '```bash', 'cp .env.example .env', '```', 'Fill in your LLM API key (e.g. `OPENROUTER_API_KEY`) and any other service credentials in `.env`.');
+    if (dockerComposeYaml) {
+        readmeLines.push('', '### 3. Start Local Services (Docker)', '```bash', 'npm run services:up', '```', '*(To stop services later, run `npm run services:down`)*');
+    }
     if (hasMemory) {
-        readmeLines.push('', '### Database Setup', 'This instance uses PostgreSQL Memory for durable claims and directives.', 'Ensure `DATABASE_URL` in `.env` is reachable, then run migrations:', '```bash', 'npx @vxnus/siduri db push', '```');
+        readmeLines.push('', `### ${dockerComposeYaml ? '4' : '3'}. Database Migrations`, 'Ensure `DATABASE_URL` in `.env` is reachable, then push the memory organ PostgreSQL schema:', '```bash', 'npx @vxnus/siduri db push', '```');
     }
-    const hasBody = manifests.some((m) => m.organType === 'body');
+    readmeLines.push('', `### ${hasMemory ? (dockerComposeYaml ? '5' : '4') : (dockerComposeYaml ? '4' : '3')}. Diagnostics & Health Probe`, 'Verify all environment variables, services, and organ connections:', '```bash', 'npm run doctor', '```', '', `### ${hasMemory ? (dockerComposeYaml ? '6' : '5') : (dockerComposeYaml ? '5' : '4')}. Start Companion & Web Console`, 'Launch your companion runtime and Web UI / Memory Control Panel:', '```bash', 'npm start', '```', 'Then open `http://localhost:3000` in your browser.');
     if (hasBody) {
         readmeLines.push('', '### Avatar Assets', 'Place your Live2D Cubism model assets into `./assets/body/model/`:', '- `model.model3.json`', '- `model.moc3`', '- textures directory');
     }
-    readmeLines.push('', '## Running the Instance', '', 'Start the companion:', '```bash', 'npm start', '```', '', 'Run diagnostics:', '```bash', 'npm run doctor', '```', '');
+    readmeLines.push('');
     const readmeMd = readmeLines.join('\n');
-    return {
+    const webHtml = (0, web_template_1.generateWebHtml)(instanceName, manifests);
+    const result = {
         'package.json': packageJson,
         'siduri.config.json': siduriConfigJson,
         'siduri.schema.json': siduriSchemaJson,
         '.env.example': envExample,
         'README.md': readmeMd,
         'src/index.js': srcIndexJs,
+        'public/index.html': webHtml,
         createAssetsBodyDir: hasBody,
     };
+    if (dockerComposeYaml) {
+        result['docker-compose.yml'] = dockerComposeYaml;
+    }
+    return result;
 }

package/dist/generator.test.js

@@ -152,7 +152,26 @@ describe('Instance Generator Composition Invariants (Phase 3)', () => {
         expect(pkg.dependencies['@siduri-x/voice']).toBeDefined();
         // Body asset directory requested
         expect(files.createAssetsBodyDir).toBe(true);
-        // README mentions Live2D model assets
+        // README mentions Live2D model assets & prerequisites
         expect(files['README.md']).toContain('assets/body/model');
+        expect(files['README.md']).toContain('Prerequisites');
+        // Docker compose generated for memory & voice
+        expect(files['docker-compose.yml']).toBeDefined();
+        expect(files['docker-compose.yml']).toContain('postgres:15');
+        expect(files['docker-compose.yml']).toContain('voicevox/voicevox_engine');
+        expect(pkg.scripts['services:up']).toBe('docker compose up -d');
+        expect(pkg.scripts['services:down']).toBe('docker compose down');
+    });
+    test('Composition E: Brain only has no docker-compose.yml', () => {
+        const files = (0, generator_1.generateInstanceFiles)({
+            name: 'brain-solo',
+            selectedManifests: [MOCK_MANIFESTS.brain],
+        });
+        expect(files['docker-compose.yml']).toBeUndefined();
+        const pkg = JSON.parse(files['package.json']);
+        expect(pkg.scripts['services:up']).toBeUndefined();
+        expect(files['public/index.html']).toBeDefined();
+        expect(files['public/index.html']).toContain('Memory Console');
+        expect(files['public/index.html']).toContain('Companion Chat');
     });
 });

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { OrganManifest } from './manifest';
-export declare const CLI_VERSION = "0.0.8";
+export declare const CLI_VERSION = "0.0.9";
 export declare const colors: {
     cyan: string;
     dim: string;