@vxnus/siduri 0.0.7 → 0.0.9

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,4 +1,20 @@
 #!/usr/bin/env node
+import { OrganManifest } from './manifest';
+export declare const CLI_VERSION = "0.0.9";
+export declare const colors: {
+    cyan: string;
+    dim: string;
+    green: string;
+    yellow: string;
+    bold: string;
+    reset: string;
+};
+export declare function printHeader(): void;
+export declare function printSection(title: string): void;
+export declare function printSuccess(message: string): void;
+export declare function projectDirectoryName(value: string): string;
+export declare function formatReviewSummary(companionName: string, selectedManifests: OrganManifest[], organSummaries: Record<string, Record<string, unknown>>): string;
+export declare function withTask<T>(label: string, task: () => Promise<T>): Promise<T>;
 export declare function runCreateWizard(targetDir?: string): Promise<void>;
 export declare function runCliDoctor(targetDir?: string): Promise<void>;
 export declare function runCliDb(subcommand?: string, targetDir?: string): Promise<void>;