siduri 1.0.0

package/dist/generator.js

@@ -0,0 +1,1094 @@
+"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 || {};
+    const config = {};
+    for (const [key, val] of Object.entries(props)) {
+        if (val.default !== undefined) {
+            config[key] = val.default;
+        }
+        else if (val.enum && val.enum.length > 0) {
+            config[key] = val.enum[0];
+        }
+        else if (val.type === 'string') {
+            config[key] = '';
+        }
+        else if (val.type === 'number') {
+            config[key] = 0;
+        }
+        else if (val.type === 'boolean') {
+            config[key] = false;
+        }
+        else if (val.type === 'array') {
+            config[key] = [];
+        }
+        else if (val.type === 'object') {
+            config[key] = {};
+        }
+    }
+    // Provide sensible defaults for known common keys if missing
+    if (manifest.organType === 'brain') {
+        config.provider = config.provider || 'openrouter';
+        config.model = config.model || 'anthropic/claude-3.5-sonnet';
+        config.apiKeyEnv = 'OPENROUTER_API_KEY';
+    }
+    else if (manifest.organType === 'memory') {
+        config.provider = config.provider || 'sqlite';
+    }
+    else if (manifest.organType === 'voice') {
+        config.provider = config.provider || 'voicevox';
+        config.speakerId = config.speakerId || 1;
+        config.baseUrl = config.baseUrl || 'http://localhost:50021';
+    }
+    else if (manifest.organType === 'body') {
+        config.provider = config.provider || 'live2d';
+        config.initialExpression = config.initialExpression || 'neutral';
+        config.modelPath = config.modelPath || './assets/body/default/model.model3.json';
+        config.modelUrl = config.modelUrl || '/assets/body/default/model.model3.json';
+    }
+    else if (manifest.organType === 'hands') {
+        config.defaultTimeoutMs = config.defaultTimeoutMs || 10000;
+        config.providers = config.providers || [];
+    }
+    else if (manifest.organType === 'knowledge') {
+        config.provider = config.provider || 'unified';
+        config.lifeDatabase = config.lifeDatabase ?? true;
+        config.dbPath = config.dbPath || 'siduri.sqlite';
+    }
+    else if (manifest.organType === 'behavior') {
+        config.provider = config.provider || 'active_self';
+    }
+    else if (manifest.organType === 'vision') {
+        config.provider = config.provider || 'openrouter';
+        config.model = config.model || 'gpt-4-vision';
+    }
+    else if (manifest.organType === 'mouth') {
+        config.defaultMedium = 'web';
+        config.maxTextLength = config.maxTextLength || 8000;
+    }
+    return config;
+}
+function generateInstanceFiles(options) {
+    const instanceName = options.name || 'my-siduri';
+    const instanceId = options.id || 'default';
+    const coreVersion = options.coreVersion || '^1.0.0';
+    const cliVersion = options.cliVersion || '^2.1.0';
+    const canonicalOrder = ['brain', 'archive', 'knowledge', 'behavior', 'voice', 'body', 'mouth', 'hands', 'vision', 'ear', 'observation'];
+    const manifests = [...options.selectedManifests].sort((a, b) => {
+        const idxA = canonicalOrder.indexOf(a.organType);
+        const idxB = canonicalOrder.indexOf(b.organType);
+        return (idxA === -1 ? 99 : idxA) - (idxB === -1 ? 99 : idxB);
+    });
+    const hasArchive = manifests.some((m) => m.organType === 'archive');
+    const hasVoice = manifests.some((m) => m.organType === 'voice');
+    const hasBody = manifests.some((m) => m.organType === 'body');
+    const hasMouth = manifests.some((m) => m.organType === 'mouth');
+    const hasVision = manifests.some((m) => m.organType === 'vision');
+    const voiceConfig = options.organConfigs?.voice || options.organConfigs?.['@sidurijs/voice'];
+    const isVoicevox = hasVoice && (!voiceConfig || voiceConfig.provider === 'voicevox');
+    // 1. package.json
+    const dependencies = {};
+    if (options.localPath) {
+        const repoPath = options.localPath.replace(/\\/g, '/');
+        dependencies['@sidurijs/core'] = `file:${repoPath}/packages/core`;
+        for (const m of manifests) {
+            const organRel = ['@sidurijs/archive', '@sidurijs/knowledge', '@sidurijs/self'].includes(m.name)
+                ? `packages/${m.name.slice('@sidurijs/'.length)}`
+                : `packages/organs/${m.name.slice('@sidurijs/'.length)}`;
+            dependencies[m.name] = `file:${repoPath}/${organRel}`;
+        }
+    }
+    else {
+        dependencies['@sidurijs/core'] = coreVersion;
+        for (const m of manifests) {
+            dependencies[m.name] = `^${m.version || '1.0.0'}`;
+        }
+    }
+    const scripts = {
+        start: 'node src/index.js',
+        dev: 'node --watch src/index.js',
+        reset: 'siduri reset',
+        doctor: 'siduri doctor',
+        db: 'siduri db',
+    };
+    const devDependencies = {
+        '@vxnus/siduri': cliVersion,
+    };
+    const packageJsonObj = {
+        name: instanceName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'my-siduri',
+        private: true,
+        type: 'module',
+        engines: {
+            node: '>=22.16.0',
+        },
+        scripts,
+        dependencies,
+        devDependencies,
+    };
+    const packageJson = JSON.stringify(packageJsonObj, null, 2) + '\n';
+    // 3. siduri.config.json
+    const organsConfig = {};
+    for (const m of manifests) {
+        const customConfig = options.organConfigs?.[m.configKey] || options.organConfigs?.[m.organType];
+        organsConfig[m.configKey] = customConfig || getDefaultConfigForManifest(m);
+    }
+    const configObj = {
+        $schema: './siduri.schema.json',
+        id: instanceId,
+        name: instanceName,
+        organs: organsConfig,
+    };
+    const siduriConfigJson = JSON.stringify(configObj, null, 2) + '\n';
+    // 4. siduri.schema.json
+    const organPropertiesSchema = {};
+    for (const m of manifests) {
+        organPropertiesSchema[m.configKey] = m.configSchema || { type: 'object' };
+    }
+    const schemaObj = {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        title: `Siduri Configuration Schema (${instanceName})`,
+        type: 'object',
+        required: ['id', 'name', 'organs'],
+        additionalProperties: false,
+        properties: {
+            $schema: { type: 'string' },
+            id: { type: 'string', description: 'Unique companion isolation ID' },
+            name: { type: 'string', description: 'Display name of the companion' },
+            organs: {
+                type: 'object',
+                additionalProperties: false,
+                properties: organPropertiesSchema,
+            },
+        },
+    };
+    const siduriSchemaJson = JSON.stringify(schemaObj, null, 2) + '\n';
+    // 5. .env.example
+    const envLines = [];
+    for (const m of manifests) {
+        if (m.environment && m.environment.length > 0) {
+            envLines.push(`# ${m.displayName || m.name}`);
+            for (const envVar of m.environment) {
+                if (envVar.description) {
+                    envLines.push(`# ${envVar.description}${envVar.required ? ' (required)' : ' (optional)'}`);
+                }
+                const defaultVal = envVar.default || '';
+                envLines.push(`${envVar.name}=${defaultVal}`);
+            }
+            envLines.push('');
+        }
+    }
+    const envExample = envLines.length > 0 ? envLines.join('\n') : '# No external environment variables required\n';
+    // 6. src/index.js
+    const importLines = [
+        `import { createServer } from 'node:http';`,
+        `import { readFile, stat, readdir } from 'node:fs/promises';`,
+        `import path from 'node:path';`,
+        `import { fileURLToPath } from 'node:url';`,
+        `import { SiduriRuntime, dispatchCompanionChat, validateCompanionConfig } from '@sidurijs/core';`,
+    ];
+    for (const m of manifests) {
+        if (m.name === '@sidurijs/self') {
+            importLines.push(`import { ActiveSelfCompiler, SqliteSelfRepository, SelfPackageParser, scanDirective, compilePersonaDocument } from '@sidurijs/self';`);
+        }
+        else {
+            importLines.push(`import { ${m.factory} } from '${m.name}';`);
+        }
+    }
+    const instantiationLines = [];
+    const organMapEntries = [];
+    for (const m of manifests) {
+        if (m.name === '@sidurijs/self') {
+            instantiationLines.push(`const self = new SqliteSelfRepository({ dbPath: path.resolve(rootDir, 'siduri.sqlite') });`);
+            instantiationLines.push(`const behavior = new ActiveSelfCompiler(config.organs.behavior);`);
+            // NOTE: .self file is NOT auto-installed on startup.
+            // It is detected by GET /teach/detected-self and surfaced in the chat UI
+            // for user review and approval via the inline persona proposal card.
+            organMapEntries.push(`  behavior,`);
+            organMapEntries.push(`  self,`);
+        }
+        else if (m.name === '@sidurijs/archive') {
+            instantiationLines.push(`const archive = new ${m.factory}({ ...config.organs.${m.configKey}, dbPath: path.resolve(rootDir, config.organs.${m.configKey}?.dbPath || 'siduri.sqlite') });`);
+            organMapEntries.push(`  ${m.configKey},`);
+        }
+        else if (m.name === '@sidurijs/knowledge') {
+            instantiationLines.push(`const knowledge = new ${m.factory}({ ...config.organs.${m.configKey}, dbPath: path.resolve(rootDir, config.organs.${m.configKey}?.dbPath || 'siduri.sqlite') });`);
+            organMapEntries.push(`  ${m.configKey},`);
+        }
+        else if (m.name === '@sidurijs/observation') {
+            const visionArg = hasVision ? 'vision' : '{ analyze: async () => JSON.stringify({ readings: [] }) }';
+            instantiationLines.push(`const observation = new ${m.factory}(${visionArg});`);
+            organMapEntries.push(`  ${m.configKey},`);
+        }
+        else {
+            const varName = m.configKey;
+            instantiationLines.push(`const ${varName} = new ${m.factory}(config.organs.${m.configKey});`);
+            organMapEntries.push(`  ${varName},`);
+        }
+    }
+    if (hasMouth && hasVoice) {
+        instantiationLines.push(`if (typeof mouth?.setVoiceOrgan === 'function') mouth.setVoiceOrgan(voice);`);
+    }
+    const selectedDisplayNames = manifests.map((m) => m.displayName.split(' ')[0] || m.organType).join(', ');
+    const srcIndexJs = [
+        ...importLines,
+        '',
+        `const __filename = fileURLToPath(import.meta.url);`,
+        `const __dirname = path.dirname(__filename);`,
+        `const rootDir = path.resolve(__dirname, '..');`,
+        '',
+        `// Load local .env into process.env, giving project-level .env precedence over ambient shell variables`,
+        `try {`,
+        `  const envPath = path.join(rootDir, '.env');`,
+        `  const envContent = await readFile(envPath, 'utf8');`,
+        `  for (const line of envContent.split('\\n')) {`,
+        `    const trimmed = line.trim();`,
+        `    if (!trimmed || trimmed.startsWith('#')) continue;`,
+        `    const eqIdx = trimmed.indexOf('=');`,
+        `    if (eqIdx !== -1) {`,
+        `      const key = trimmed.slice(0, eqIdx).trim();`,
+        `      let val = trimmed.slice(eqIdx + 1).trim();`,
+        `      if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {`,
+        `        val = val.slice(1, -1);`,
+        `      }`,
+        `      if (val) {`,
+        `        process.env[key] = val;`,
+        `      }`,
+        `    }`,
+        `  }`,
+        `} catch (err) {`,
+        `  if (err?.code !== 'ENOENT') {`,
+        `    console.error('Failed to load .env file:', err.message);`,
+        `  }`,
+        `}`,
+        '',
+        `const config = JSON.parse(`,
+        `  await readFile(path.join(rootDir, 'siduri.config.json'), 'utf8')`,
+        `);`,
+        `const schemaPath = path.join(rootDir, 'siduri.schema.json');`,
+        `try {`,
+        `  const schema = JSON.parse(await readFile(schemaPath, 'utf8'));`,
+        `  validateCompanionConfig(config, schema);`,
+        `} catch (err) {`,
+        `  if (err?.code !== 'ENOENT') {`,
+        `    console.error('Config validation failed:', err.message);`,
+        `    throw err;`,
+        `  }`,
+        `}`,
+        '',
+        ...instantiationLines,
+        '',
+        `const runtime = new SiduriRuntime(config.id, config, {`,
+        ...organMapEntries,
+        `});`,
+        '',
+        `await runtime.initialize();`,
+        '',
+        `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 (minimal safe operational state, no secrets/credentials/config.organs)`,
+        `  if ((pathname === '/health' || pathname === '/api/status') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({`,
+        `      status: 'ok',`,
+        `      uptime: process.uptime(),`,
+        `    }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Ready probe`,
+        `  if (pathname === '/ready' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ status: 'ready', companionId: config.id }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Version info`,
+        `  if (pathname === '/version' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ version: '2.0.3', name: config.name, id: config.id }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Identity info`,
+        `  if ((pathname === '/me' || pathname === '/teach/identity') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    let identity = null;`,
+        `    try {`,
+        `      identity = typeof self?.getIdentity === 'function' ? await self.getIdentity(config.id) : null;`,
+        `    } catch {}`,
+        `    res.end(JSON.stringify({`,
+        `      id: config.id,`,
+        `      companionId: config.id,`,
+        `      name: identity?.name || undefined,`,
+        `      archetype: identity?.archetype || identity?.role,`,
+        `      origin: identity?.origin,`,
+        `      ethos: identity?.ethos,`,
+        `      version: identity?.version || '1.0.0',`,
+        `      organs: Object.keys(config.organs || {}),`,
+        `    }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Teach Mode detected-self`,
+        `  if (pathname === '/teach/detected-self' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    if (typeof SelfPackageParser === 'undefined') {`,
+        `      res.end(JSON.stringify({ detected: false }));`,
+        `      return;`,
+        `    }`,
+        `    try {`,
+        `      const companionId = parsedUrl.searchParams.get('companionId') || config.id || 'default';`,
+        `      const explicitPath = parsedUrl.searchParams.get('path');`,
+        `      const envPath = process.env.SIDURI_SELF_PATH || process.env.SELF_PATH;`,
+        `      const configPath = config.organs?.behavior?.selfPath;`,
+        `      const candidates = [];`,
+        `      if (explicitPath) candidates.push(path.resolve(rootDir, explicitPath));`,
+        `      if (envPath) candidates.push(path.resolve(rootDir, envPath));`,
+        `      if (configPath) candidates.push(path.resolve(rootDir, configPath));`,
+        `      candidates.push(path.resolve(rootDir, 'assets', 'self', companionId + '.self'));`,
+        `      candidates.push(path.resolve(rootDir, 'assets', 'self', 'default.self'));`,
+        `      candidates.push(path.resolve(rootDir, companionId + '.self'));`,
+        '',
+        `      const searchDirs = [`,
+        `        path.resolve(rootDir, 'assets', 'self'),`,
+        `        path.resolve(rootDir, 'assets'),`,
+        `        path.resolve(rootDir),`,
+        `      ];`,
+        '',
+        `      let matchedFilePath = null;`,
+        `      for (const candidate of candidates) {`,
+        `        try {`,
+        `          const s = await stat(candidate);`,
+        `          if (s.isFile()) {`,
+        `            matchedFilePath = candidate;`,
+        `            break;`,
+        `          }`,
+        `        } catch {}`,
+        `      }`,
+        '',
+        `      if (!matchedFilePath) {`,
+        `        for (const dir of searchDirs) {`,
+        `          try {`,
+        `            const entries = await readdir(dir);`,
+        `            const selfFiles = entries.filter((f) => f.endsWith('.self'));`,
+        `            if (selfFiles.length > 0) {`,
+        `              const companionSelf = selfFiles.find((f) => f === companionId + '.self');`,
+        `              matchedFilePath = path.join(dir, companionSelf || selfFiles[0]);`,
+        `              break;`,
+        `            }`,
+        `          } catch {}`,
+        `        }`,
+        `      }`,
+        '',
+        `      if (!matchedFilePath) {`,
+        `        res.end(JSON.stringify({ detected: false }));`,
+        `        return;`,
+        `      }`,
+        '',
+        `      const content = await readFile(matchedFilePath, 'utf8');`,
+        `      const parsed = typeof compilePersonaDocument === 'function'`,
+        `        ? await compilePersonaDocument(content, { brain: runtime?.brain, companionId })`,
+        `        : SelfPackageParser.parse(content);`,
+        `      let alreadyInstalled = false;`,
+        `      if (typeof self?.getIdentity === 'function') {`,
+        `        try {`,
+        `          const existingIdentity = await self.getIdentity(companionId);`,
+        `          const existingDirectives = await self.getActiveDirectives(companionId);`,
+        `          if (`,
+        `            existingIdentity &&`,
+        `            parsed.manifest?.identity?.name &&`,
+        `            existingIdentity.name.toLowerCase() === parsed.manifest.identity.name.toLowerCase() &&`,
+        `            existingDirectives.length > 0`,
+        `          ) {`,
+        `            alreadyInstalled = true;`,
+        `          }`,
+        `        } catch {}`,
+        `      }`,
+        '',
+        `      res.end(JSON.stringify({`,
+        `        detected: true,`,
+        `        filename: path.basename(matchedFilePath),`,
+        `        path: path.relative(rootDir, matchedFilePath),`,
+        `        content,`,
+        `        parsed,`,
+        `        alreadyInstalled,`,
+        `      }));`,
+        `    } catch (err) {`,
+        `      res.end(JSON.stringify({ detected: false, error: err.message }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Teach Mode upload-self`,
+        `  if (pathname === '/teach/upload-self' && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', async () => {`,
+        `      if (typeof compilePersonaDocument === 'undefined' && typeof SelfPackageParser === 'undefined') {`,
+        `        res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: 'Self organ is not configured' }));`,
+        `        return;`,
+        `      }`,
+        `      try {`,
+        `        const { content, companionId } = JSON.parse(body || '{}');`,
+        `        if (!content) {`,
+        `          res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `          res.end(JSON.stringify({ error: 'Missing content' }));`,
+        `          return;`,
+        `        }`,
+        `        const targetId = companionId || config.id || 'default';`,
+        `        const parsed = typeof compilePersonaDocument === 'function'`,
+        `          ? await compilePersonaDocument(content, { brain: runtime?.brain, companionId: targetId })`,
+        `          : SelfPackageParser.parse(content);`,
+        `        res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify(parsed));`,
+        `      } catch (err) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: err.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Teach Mode install-self`,
+        `  if (pathname === '/teach/install-self' && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', async () => {`,
+        `      if (typeof self === 'undefined' || typeof self?.setIdentity !== 'function') {`,
+        `        res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: 'Self organ is not configured' }));`,
+        `        return;`,
+        `      }`,
+        `      try {`,
+        `        const { companionId, manifest, approvedDirectiveIds } = JSON.parse(body || '{}');`,
+        `        const cid = companionId || config.id || 'default';`,
+        `        if (!manifest || !Array.isArray(approvedDirectiveIds)) {`,
+        `          res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `          res.end(JSON.stringify({ error: 'Missing required fields' }));`,
+        `          return;`,
+        `        }`,
+        `        if (!manifest.identity || !manifest.identity.name) {`,
+        `          res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `          res.end(JSON.stringify({ error: 'Invalid manifest: missing identity.name' }));`,
+        `          return;`,
+        `        }`,
+        `        const directivesToCommit = manifest.directives?.filter((d) => approvedDirectiveIds.includes(d.id)) || [];`,
+        `        for (const d of directivesToCommit) {`,
+        `          if (!d || typeof d.directive !== 'string') {`,
+        `            res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `            res.end(JSON.stringify({ error: 'Invalid directive entry: missing directive string' }));`,
+        `            return;`,
+        `          }`,
+        `          const scan = typeof scanDirective === 'function' ? scanDirective(d.directive) : { safe: true };`,
+        `          if (!scan.safe) {`,
+        `            res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `            res.end(JSON.stringify({ error: 'Safety check failed for directive: ' + scan.reason, directiveId: d.id, reason: scan.reason }));`,
+        `            return;`,
+        `          }`,
+        `        }`,
+        '',
+        `        await self.setIdentity({`,
+        `          companionId: cid,`,
+        `          name: manifest.identity.name,`,
+        `          archetype: manifest.identity.archetype,`,
+        `          origin: manifest.identity.origin,`,
+        `          ethos: manifest.identity.ethos,`,
+        `          version: manifest.version || '1.0.0',`,
+        `          updatedAt: new Date().toISOString(),`,
+        `        });`,
+        `        if (directivesToCommit.length > 0 && typeof self.commitDirectives === 'function') {`,
+        `          await self.commitDirectives(cid, directivesToCommit.map((d) => ({`,
+        `            id: d.id,`,
+        `            companionId: cid,`,
+        `            directive: d.directive,`,
+        `            category: d.category || 'behavioral',`,
+        `            status: 'active',`,
+        `            priority: d.priority || 50,`,
+        `            createdAt: new Date().toISOString(),`,
+        `          })));`,
+        `        }`,
+        '',
+        `        res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ success: true, companionId: cid, installedDirectives: directivesToCommit.length }));`,
+        `      } catch (err) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: err.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Voice & Observation health probes`,
+        `  if (pathname === '/voice/health' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ provider: config.organs?.voice?.provider || 'none', configured: Boolean(runtime.voice) }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  if (pathname === '/obs/health' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ provider: config.organs?.vision?.provider || 'none', configured: Boolean(runtime.vision) }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Evidence & observations`,
+        `  if ((pathname === '/evidence' || pathname === '/observations') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ items: [] }));`,
+        `    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 & Behavioral Approval / Rejection`,
+        `  if ((pathname === '/memory/proposals/approve' || pathname === '/memory/proposals/reject' || pathname === '/memory/behavioral/approve' || pathname === '/memory/behavioral/reject') && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', async () => {`,
+        `      try {`,
+        `        const payload = JSON.parse(body || '{}');`,
+        `        const claimId = payload.id || payload.claimId || payload.directiveId;`,
+        `        if (!claimId) {`,
+        `          res.writeHead(400, { 'Content-Type': 'application/json' });`,
+        `          res.end(JSON.stringify({ error: 'Missing required id' }));`,
+        `          return;`,
+        `        }`,
+        `        if (pathname.endsWith('approve')) {`,
+        `          let name = null;`,
+        `          if (pathname.includes('behavioral')) {`,
+        `            if (typeof runtime?.approveDirective === 'function') {`,
+        `              const bRes = await runtime.approveDirective(claimId, { companionId: config.id });`,
+        `              name = bRes?.name;`,
+        `            } else if (typeof self?.approveDirective === 'function') {`,
+        `              await self.approveDirective(claimId, config.id);`,
+        `            }`,
+        `          } else if (typeof runtime?.approveProposal === 'function') {`,
+        `            const pRes = await runtime.approveProposal(claimId, { companionId: config.id });`,
+        `            name = pRes?.name;`,
+        `          } else if (typeof memory?.approveClaim === 'function') {`,
+        `            await memory.approveClaim(claimId);`,
+        `          }`,
+        `          if (!name && typeof self?.getIdentity === 'function') {`,
+        `            try {`,
+        `              const ident = await self.getIdentity(config.id);`,
+        `              name = ident?.name;`,
+        `            } catch {}`,
+        `          }`,
+        `          res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `          res.end(JSON.stringify({ approved: true, id: claimId, status: 'approved', name: name || undefined }));`,
+        `        } else {`,
+        `          if (pathname.includes('behavioral')) {`,
+        `            if (typeof runtime?.rejectDirective === 'function') {`,
+        `              await runtime.rejectDirective(claimId, { companionId: config.id });`,
+        `            } else if (typeof self?.rejectDirective === 'function') {`,
+        `              await self.rejectDirective(claimId, config.id);`,
+        `            }`,
+        `          } else if (typeof memory?.rejectClaim === 'function') {`,
+        `            await memory.rejectClaim(claimId);`,
+        `          }`,
+        `          res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `          res.end(JSON.stringify({ rejected: true, id: claimId, status: 'rejected' }));`,
+        `        }`,
+        `      } catch (err) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: err.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        ``,
+        `  // API: System Logs`,
+        `  if ((pathname === '/system/logs' || pathname === '/api/system/logs') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    try {`,
+        `      const level = parsedUrl.searchParams.get('level') || undefined;`,
+        `      const subsystem = parsedUrl.searchParams.get('subsystem') || undefined;`,
+        `      const q = parsedUrl.searchParams.get('q') || undefined;`,
+        `      const limit = parseInt(parsedUrl.searchParams.get('limit') || '100', 10);`,
+        `      const offset = parseInt(parsedUrl.searchParams.get('offset') || '0', 10);`,
+        `      const logs = typeof runtime?.queryLogs === 'function'`,
+        `        ? runtime.queryLogs({ companionId: config.id, level, subsystem, q, limit, offset })`,
+        `        : (typeof self?.db?.queryLogs === 'function' ? self.db.queryLogs({ companionId: config.id, level, subsystem, q, limit, offset }) : []);`,
+        `      res.end(JSON.stringify({ logs }));`,
+        `    } catch (e) {`,
+        `      res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `      res.end(JSON.stringify({ error: e.message, logs: [] }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        ``,
+        `  if ((pathname === '/system/logs/clear' || pathname === '/api/system/logs/clear' || (pathname === '/system/logs' && req.method === 'DELETE')) && (req.method === 'POST' || req.method === 'DELETE')) {`,
+        `    try {`,
+        `      if (typeof runtime?.clearLogs === 'function') {`,
+        `        runtime.clearLogs(config.id);`,
+        `      } else if (typeof self?.db?.clearLogs === 'function') {`,
+        `        self.db.clearLogs(config.id);`,
+        `      }`,
+        `      res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `      res.end(JSON.stringify({ cleared: true }));`,
+        `    } catch (e) {`,
+        `      res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `      res.end(JSON.stringify({ error: e.message }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Memory & State Reset (Return to blank slate)`,
+        `  if ((pathname === '/api/reset' || pathname === '/memory/reset' || pathname === '/dev/memory/reset') && req.method === 'POST') {`,
+        `    try {`,
+        `      if (typeof memory?.resetMemory === 'function') {`,
+        `        await memory.resetMemory(config.id);`,
+        `      }`,
+        `      res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `      res.end(JSON.stringify({ reset: true, companionId: config.id, status: 'blank_slate' }));`,
+        `    } catch (err) {`,
+        `      res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `      res.end(JSON.stringify({ error: err.message }));`,
+        `    }`,
+        `    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 (routed through canonical dispatchCompanionChat from @sidurijs/core)`,
+        `  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 chatContext = {`,
+        `          companionId: config.id,`,
+        `          actor: {`,
+        `            actorId: 'owner-user',`,
+        `            sessionId: \`sess-\${config.id}\`,`,
+        `            authorizationRole: 'administrator',`,
+        `            capabilities: ['chat', 'memory:approve', 'action:execute'],`,
+        `            authenticated: true,`,
+        `          },`,
+        `          conversation: {`,
+        `            channel: 'direct',`,
+        `            correlationId: \`corr-\${Date.now()}\`,`,
+        `          },`,
+        `          source: 'local',`,
+        `          ...(payload.context || {}),`,
+        `          ...(payload.mode ? { mode: payload.mode } : {}),`,
+        `        };`,
+        `        const response = await dispatchCompanionChat(runtime, {`,
+        `          id: config.id,`,
+        `          companionId: config.id,`,
+        `          message: payload.message || payload.text || '',`,
+        `          context: chatContext,`,
+        `          history: Array.isArray(payload.history) ? payload.history : [],`,
+        `          subtitleLanguage: payload.subtitleLanguage || payload.subtitle_language,`,
+        `        });`,
+        '',
+        `        res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify(response));`,
+        `      } catch (err) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: err.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Real-time SSE streaming (Mouth transport)`,
+        `  if ((pathname === '/chat/stream' || pathname === '/api/chat/stream') && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', async () => {`,
+        `      res.writeHead(200, {`,
+        `        'Content-Type': 'text/event-stream',`,
+        `        'Cache-Control': 'no-cache, no-transform',`,
+        `        'Connection': 'keep-alive',`,
+        `      });`,
+        `      const abortController = new AbortController();`,
+        `      const onClose = () => {`,
+        `        if (!res.writableEnded) {`,
+        `          abortController.abort('client_disconnect');`,
+        `          if (runtime.mouth && typeof runtime.mouth.interrupt === 'function') {`,
+        `            runtime.mouth.interrupt('client_disconnect');`,
+        `          }`,
+        `        }`,
+        `      };`,
+        `      res.on('close', onClose);`,
+        '',
+        `      try {`,
+        `        const payload = JSON.parse(body || '{}');`,
+        `        const chatContext = {`,
+        `          companionId: config.id,`,
+        `          actor: {`,
+        `            actorId: 'owner-user',`,
+        `            sessionId: \`sess-\${config.id}\`,`,
+        `            authorizationRole: 'administrator',`,
+        `            capabilities: ['chat', 'memory:approve', 'action:execute'],`,
+        `            authenticated: true,`,
+        `          },`,
+        `          conversation: {`,
+        `            channel: 'direct',`,
+        `            correlationId: \`corr-\${Date.now()}\`,`,
+        `          },`,
+        `          source: 'local',`,
+        `          ...(payload.context || {}),`,
+        `          ...(payload.mode ? { mode: payload.mode } : {}),`,
+        `        };`,
+        `        const response = await dispatchCompanionChat(runtime, {`,
+        `          id: config.id,`,
+        `          companionId: config.id,`,
+        `          message: payload.message || payload.text || '',`,
+        `          context: chatContext,`,
+        `          history: Array.isArray(payload.history) ? payload.history : [],`,
+        `          medium: 'web',`,
+        `          signal: abortController.signal,`,
+        `          subtitleLanguage: payload.subtitleLanguage || payload.subtitle_language,`,
+        `        });`,
+        '',
+        `        res.write(\`event: staged\\ndata: \${JSON.stringify({ response_id: response.response_id, correlation_id: response.correlation_id, status: response.status })}\\n\\n\`);`,
+        '',
+        `        const avatarEvent = response.metadata?.events?.find(`,
+        `          (e) => (e.kind === 'avatar' || e.kind === 'body') && (e.approval?.toLowerCase() === 'approved' || !e.approval)`,
+        `        );`,
+        `        if (avatarEvent) {`,
+        `          res.write(\`event: avatar\\ndata: \${JSON.stringify(avatarEvent)}\\n\\n\`);`,
+        `        }`,
+        '',
+        `        const speechText = response.delivery?.text || response.response?.subtitle_en || response.response?.spoken_ja || '';`,
+        `        const utterance = {`,
+        `          utteranceId: response.response_id || 'utt-stream',`,
+        `          companionId: config.id,`,
+        `          responseId: response.response_id,`,
+        `          correlationId: response.correlation_id,`,
+        `          text: speechText,`,
+        `          medium: 'web',`,
+        `          expression: avatarEvent?.expression,`,
+        `          action: avatarEvent?.action,`,
+        `          signal: abortController.signal,`,
+        `        };`,
+        '',
+        `        if (runtime.mouth && typeof runtime.mouth.stream === 'function') {`,
+        `          for await (const chunk of runtime.mouth.stream(utterance)) {`,
+        `            if (abortController.signal.aborted) {`,
+        `              res.write(\`event: chunk\\ndata: \${JSON.stringify({ ...chunk, interrupted: true })}\\n\\n\`);`,
+        `              break;`,
+        `            }`,
+        `            res.write(\`event: chunk\\ndata: \${JSON.stringify(chunk)}\\n\\n\`);`,
+        `          }`,
+        `        } else {`,
+        `          res.write(\`event: chunk\\ndata: \${JSON.stringify({ utteranceId: utterance.utteranceId, index: 1, deltaText: speechText, isComplete: true, medium: 'web' })}\\n\\n\`);`,
+        `        }`,
+        '',
+        `        res.write(\`event: done\\ndata: \${JSON.stringify(response)}\\n\\n\`);`,
+        `        res.end();`,
+        `      } catch (err) {`,
+        `        if (abortController.signal.aborted) {`,
+        `          res.write(\`event: interrupted\\ndata: \${JSON.stringify({ reason: abortController.signal.reason })}\\n\\n\`);`,
+        `        } else {`,
+        `          res.write(\`event: error\\ndata: \${JSON.stringify({ error: err.message })}\\n\\n\`);`,
+        `        }`,
+        `        res.end();`,
+        `      } finally {`,
+        `        res.removeListener('close', onClose);`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Barge-in interruption`,
+        `  if ((pathname === '/chat/interrupt' || pathname === '/mouth/interrupt' || pathname === '/api/chat/interrupt') && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', () => {`,
+        `      try {`,
+        `        const payload = JSON.parse(body || '{}');`,
+        `        const reason = payload.reason || 'user_barge_in';`,
+        `        if (runtime.mouth && typeof runtime.mouth.interrupt === 'function') {`,
+        `          runtime.mouth.interrupt(reason);`,
+        `        }`,
+        `        res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ success: true, interrupted: true, reason }));`,
+        `      } catch (e) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: e.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Mouth channels & health`,
+        `  if ((pathname === '/mouth/health' || pathname === '/api/mouth/health') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ provider: 'siduri-mouth', configured: Boolean(runtime.mouth) }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  if ((pathname === '/mouth/channels' || pathname === '/api/mouth/channels') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    const channels = typeof runtime.mouth?.getRegisteredChannels === 'function' ? runtime.mouth.getRegisteredChannels() : [];`,
+        `    res.end(JSON.stringify({ channels }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Model Catalog Discovery (Body & Voice)`,
+        `  if (pathname === '/api/models/body' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    try {`,
+        `      const bodyDir = path.join(rootDir, 'assets', 'body');`,
+        `      const entries = await readdir(bodyDir, { withFileTypes: true }).catch(() => []);`,
+        `      const models = entries.filter((e) => e.isDirectory()).map((e) => e.name);`,
+        `      res.end(JSON.stringify({ models: models.length ? models : ['default'] }));`,
+        `    } catch {`,
+        `      res.end(JSON.stringify({ models: ['default'] }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  if (pathname === '/api/models/voice' && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    try {`,
+        `      const voiceDir = path.join(rootDir, 'assets', 'voice');`,
+        `      const entries = await readdir(voiceDir, { withFileTypes: true }).catch(() => []);`,
+        `      const models = entries.filter((e) => e.isDirectory()).map((e) => e.name);`,
+        `      res.end(JSON.stringify({ models: models.length ? models : ['default'] }));`,
+        `    } catch {`,
+        `      res.end(JSON.stringify({ models: ['default'] }));`,
+        `    }`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // Static files & Next.js apps/web export routing with strict boundary verification`,
+        `  let decodedPathname = pathname;`,
+        `  try {`,
+        `    while (decodedPathname.includes('%')) {`,
+        `      const next = decodeURIComponent(decodedPathname);`,
+        `      if (next === decodedPathname) break;`,
+        `      decodedPathname = next;`,
+        `    }`,
+        `  } catch {`,
+        `    res.writeHead(400, { 'Content-Type': 'text/plain' });`,
+        `    res.end('Bad Request');`,
+        `    return;`,
+        `  }`,
+        `  const normalizedPath = path.normalize(decodedPathname).replace(/^[/\\\\]+/, '');`,
+        `  const canonicalPublicRoot = path.resolve(rootDir, 'public');`,
+        `  const canonicalAssetsRoot = path.resolve(rootDir, 'assets');`,
+        `  const candidatePairs = [`,
+        `    { root: canonicalPublicRoot, target: path.resolve(canonicalPublicRoot, normalizedPath, 'index.html') },`,
+        `    { root: canonicalPublicRoot, target: path.resolve(canonicalPublicRoot, normalizedPath + '.html') },`,
+        `    { root: canonicalPublicRoot, target: path.resolve(canonicalPublicRoot, normalizedPath) },`,
+        `  ];`,
+        '',
+        `  if (!normalizedPath || normalizedPath === '.' || normalizedPath === './') {`,
+        `    candidatePairs.unshift({ root: canonicalPublicRoot, target: path.resolve(canonicalPublicRoot, 'index.html') });`,
+        `  }`,
+        '',
+        `  // Asset serving for companion assets (e.g. /assets/body/<name>/model.model3.json)`,
+        `  if (decodedPathname.startsWith('/assets/')) {`,
+        `    const relativeAssetPath = path.normalize(decodedPathname.slice('/assets/'.length)).replace(/^[/\\\\]+/, '');`,
+        `    candidatePairs.unshift({ root: canonicalAssetsRoot, target: path.resolve(canonicalAssetsRoot, relativeAssetPath) });`,
+        `  }`,
+        '',
+        `  // Compatibility fallback for legacy /live2d/<modelName>/... -> ./assets/body/<modelName>/...`,
+        `  if (decodedPathname.startsWith('/live2d/')) {`,
+        `    const relativeAssetPath = path.normalize(decodedPathname.slice('/live2d/'.length)).replace(/^[/\\\\]+/, '');`,
+        `    candidatePairs.unshift({ root: canonicalAssetsRoot, target: path.resolve(canonicalAssetsRoot, 'body', relativeAssetPath) });`,
+        `    candidatePairs.unshift({ root: canonicalAssetsRoot, target: path.resolve(canonicalAssetsRoot, 'body', 'model', relativeAssetPath) });`,
+        `  }`,
+        '',
+        `  for (const { root, target } of candidatePairs) {`,
+        `    try {`,
+        `      // Strict path containment check: target must reside within configured root directory`,
+        `      const relative = path.relative(root, target);`,
+        `      if (relative.startsWith('..') || path.isAbsolute(relative)) {`,
+        `        continue;`,
+        `      }`,
+        `      const fileStat = await stat(target);`,
+        `      if (fileStat.isFile()) {`,
+        `        const ext = path.extname(target).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(target);`,
+        `        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(Number(PORT), '127.0.0.1', () => {`,
+        `  console.log(\`✓ Siduri [\${config.name}] initialized with [${selectedDisplayNames}].\`);`,
+        `  console.log(\`➜ Web Companion & Memory Console running at: http://127.0.0.1:\${PORT}\`);`,
+        `  if (process.env.PORT === '0') {`,
+        `    server.close();`,
+        `  }`,
+        `});`,
+        '',
+    ].join('\n');
+    // 7. README.md
+    const readmeLines = [
+        `# ${instanceName}`,
+        '',
+        `Standalone Siduri AI companion instance generated with explicitly composed organs:`,
+        '',
+        ...manifests.map((m) => `- **${m.displayName}** (\`${m.name}\`)`),
+        '',
+        '## Prerequisites',
+        '',
+        '- **Node.js**: `v22.16.0` or higher',
+        '- **Environment**: Valid `.env` file (configured from `.env.example`)',
+    ];
+    if (hasArchive) {
+        readmeLines.push('- **Database**: Embedded SQLite (`siduri.sqlite`). Automatically initialized with WAL mode and FTS5 full-text indexing with zero external setup.');
+    }
+    if (isVoicevox) {
+        readmeLines.push('- **VOICEVOX**: Note: The Voicevox engine executable will be securely auto-downloaded at runtime by Siduri if no local URL is provided.');
+    }
+    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`.');
+    readmeLines.push('', '### 3. Diagnostics & Health Probe', 'Verify all environment variables, schema conformance, services, and organ connections:', '```bash', 'npm run doctor', '```', '', '### 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.');
+    const createAssetsDirs = [];
+    if (hasBody) {
+        createAssetsDirs.push('assets/body/default');
+        readmeLines.push('', '### Body & Avatar Models', 'Place your Live2D Cubism model assets into `./assets/body/default/`:', '- `model.model3.json`', '- `model.moc3`', '- textures directory');
+    }
+    if (hasVoice) {
+        createAssetsDirs.push('assets/voice/default');
+        readmeLines.push('', '### Voice & RVC Models', 'Place your character RVC voice models into `./assets/voice/default/`:', '- `default.pth` (Target voice weights)', '- `default.index` (Feature index file)');
+    }
+    const knowledgeConfig = options.organConfigs?.knowledge || options.organConfigs?.['@sidurijs/knowledge'];
+    if (manifests.some((m) => m.organType === 'knowledge') && knowledgeConfig?.packPath) {
+        const cleanPackDir = String(knowledgeConfig.packPath).replace(/^\.\//, '');
+        createAssetsDirs.push(cleanPackDir);
+        readmeLines.push('', '### Knowledge Pack Assets', `Local knowledge pack files reside in \`./${cleanPackDir}/\`.`);
+    }
+    const behaviorConfig = options.organConfigs?.behavior || options.organConfigs?.['@sidurijs/self'];
+    let selfPersonaFile = null;
+    if (manifests.some((m) => m.organType === 'behavior')) {
+        createAssetsDirs.push('assets/self');
+        if (behaviorConfig?.mode === 'custom' || behaviorConfig?.archetype) {
+            const selfRelPath = 'assets/self/default.self';
+            const selfContent = [
+                `specVersion: "2.0.0"`,
+                `kind: "self"`,
+                `id: "default-self"`,
+                `name: "Default Persona"`,
+                `version: "1.0.0"`,
+                `author:`,
+                `  name: "Operator"`,
+                `license: "MIT"`,
+                ``,
+                `identity:`,
+                `  name: "${(behaviorConfig.name || behaviorConfig.companionName || options.name || '').replace(/"/g, '\\"')}"`,
+                `  archetype: "${(behaviorConfig.archetype || 'Knowledge Assistant & Research Partner').replace(/"/g, '\\"')}"`,
+                `  origin: "Constructed companion"`,
+                `  ethos: "${(behaviorConfig.ethos || 'Direct technical candor, thoughtful, concise, and loyal').replace(/"/g, '\\"')}"`,
+                ``,
+                `directives:`,
+                `  - id: "dir-01"`,
+                `    category: "behavioral"`,
+                `    directive: "${(behaviorConfig.directive || 'Speak concisely and stay in character without sycophantic filler').replace(/"/g, '\\"')}"`,
+                ``,
+            ].join('\n');
+            selfPersonaFile = { path: selfRelPath, content: selfContent };
+            readmeLines.push('', '### Self & Persona Assets', `Companion persona manifest resides in \`./${selfRelPath}\`.`);
+        }
+    }
+    readmeLines.push('');
+    const readmeMd = readmeLines.join('\n');
+    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,
+        createAssetsDirs,
+    };
+    if (selfPersonaFile) {
+        result[selfPersonaFile.path] = selfPersonaFile.content;
+    }
+    return result;
+}