@vxnus/siduri 2.0.0 → 2.0.2

package/README.md

@@ -2,7 +2,7 @@
 
 Experimental CLI for creating, diagnosing, and managing standalone Siduri companions powered by the `@siduri-x/*` organ ecosystem.
 
-Requires Node.js 20 or newer.
+Requires Node.js >=22.16.0.
 
 ```bash
 npx @vxnus/siduri create my-companion
@@ -10,19 +10,19 @@ npx @vxnus/siduri create my-companion
 
 ## Prerequisites
 
-- **Node.js**: `v20.0.0` or newer
+- **Node.js**: `v22.16.0` or newer
 - **LLM API Key**: e.g. `OPENROUTER_API_KEY` for Brain organ
 - **Optional Local Services**:
-  - **PostgreSQL**: Required if PostgreSQL memory organ is enabled (local PostgreSQL server or cloud Supabase/Neon).
   - **VOICEVOX**: For voice synthesis (auto-downloaded at runtime by default, or connect to standalone app).
+  - Storage is powered by embedded SQLite with WAL mode and built-in FTS5 (`siduri.sqlite`). No external database servers or Docker containers are required.
 
 ## 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, schema conformance checks, 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.
+- **Diagnostics (`siduri doctor`)**: Runs environment variable validation, schema conformance checks, storage writeability verification, external service endpoint probing, and organ health probes.
+- **Zero-Config Database**: Powered by embedded SQLite (`siduri.sqlite`). Memory and persistent state are initialized automatically at startup without manual SQL migrations.
 
 ## CLI Usage
 
@@ -53,13 +53,13 @@ npx @vxnus/siduri doctor [directory]
 
 Inspects active configuration, checks required/optional environment variables, and executes health probes.
 
-### 3. Apply Migrations
+### 3. Database Management
 
 ```bash
 npx @vxnus/siduri db push [directory]
 ```
 
-Runs database migrations exclusively for configured database organs. If no database organs are selected (e.g. Brain + Hands), reports that no migrations are needed.
+Inspects the instance storage configuration. Under the SQLite unified foundation, schema initialization and table creation are handled natively and automatically at boot.
 
 ## Local Development
 

package/dist/builtin-manifests.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUILTIN_ORGAN_MANIFESTS = void 0;
 exports.BUILTIN_ORGAN_MANIFESTS = [
     {
-        name: '@siduri-x/behavior',
+        name: '@siduri-x/self',
         organType: 'behavior',
-        version: '2.0.0',
-        displayName: 'Behavior (Active Self Directives)',
+        version: '2.0.1',
+        displayName: 'Behavior / Self (Active Self Directives)',
         description: 'Atomic directive state machine and personality projection compiler',
         entrypoint: './dist/index.js',
         factory: 'ActiveSelfCompiler',
@@ -32,7 +32,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/body',
         organType: 'body',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Body (Live2D & Avatar State)',
         description: 'Renderer-agnostic avatar expression and embodiment event adapter',
         entrypoint: './dist/index.js',
@@ -66,7 +66,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/brain',
         organType: 'brain',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Brain (Cognition & Planning)',
         description: 'Provider-neutral LLM reasoning, response planning, and proposal generation',
         entrypoint: './dist/index.js',
@@ -122,7 +122,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/ear',
         organType: 'ear',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Ear (Perception Ingress)',
         description: 'Multi-modal sensory input ingestion, transcription bounds, and mime validation',
         entrypoint: './dist/index.js',
@@ -153,7 +153,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/hands',
         organType: 'hands',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Hands (MCP Tool Execution)',
         description: 'Model Context Protocol tool management and cryptographically authorized action execution',
         entrypoint: './dist/index.js',
@@ -207,19 +207,30 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/knowledge',
         organType: 'knowledge',
-        version: '2.0.0',
-        displayName: 'Knowledge (E-Compatible Cited Facts)',
-        description: 'Factual context retrieval from local or hosted E Knowledge packs',
+        version: '2.0.1',
+        displayName: 'Knowledge (Life DB & Portable E-Packs)',
+        description: 'Sovereign Life Database (finances, inventory, schedule, preferences) and portable E knowledge packs',
         entrypoint: './dist/index.js',
-        factory: 'EKnowledgeAdapter',
+        factory: 'UnifiedKnowledgeOrgan',
         configKey: 'knowledge',
         configSchema: {
             type: 'object',
-            required: ['provider'],
             properties: {
+                lifeDatabase: {
+                    type: 'boolean',
+                    default: true
+                },
+                dbPath: {
+                    type: 'string',
+                    default: 'siduri.sqlite'
+                },
                 provider: {
                     type: 'string',
-                    enum: ['e-knowledge', 'e-remote', 'e-hub', 'none']
+                    enum: ['unified', 'e-knowledge', 'e-remote', 'e-hub', 'none'],
+                    default: 'unified'
+                },
+                pack: {
+                    type: 'object'
                 },
                 packPath: {
                     type: 'string'
@@ -266,15 +277,17 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
                 optional: true
             }
         ],
-        database: null,
+        database: {
+            engine: 'sqlite'
+        },
         healthCheck: null
     },
     {
         name: '@siduri-x/memory',
         organType: 'memory',
-        version: '2.0.0',
-        displayName: 'Memory (PostgreSQL FTS Claims)',
-        description: 'Relational semantic claims with Full-Text Search and companion isolation',
+        version: '2.0.1',
+        displayName: 'Memory (SQLite FTS5 Claims)',
+        description: 'Relational semantic claims with Full-Text Search (FTS5) and companion isolation',
         entrypoint: './dist/index.js',
         factory: 'SqliteMemoryStore',
         configKey: 'memory',
@@ -284,18 +297,11 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
             properties: {
                 provider: {
                     type: 'string',
-                    enum: ['postgres']
+                    enum: ['sqlite']
                 },
-                deployment: {
+                databasePath: {
                     type: 'string',
-                    enum: ['local', 'neon', 'supabase', 'other']
-                },
-                connectionString: {
-                    type: 'string'
-                },
-                maxConnections: {
-                    type: 'number',
-                    default: 10
+                    default: 'siduri.sqlite'
                 }
             }
         },
@@ -309,7 +315,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/observation',
         organType: 'observation',
-        version: '2.0.0',
+        version: '2.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',
@@ -327,7 +333,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/vision',
         organType: 'vision',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Vision (Visual Perception & OCR)',
         description: 'Image inspection, cropping, and multi-pass OCR perception adapter',
         entrypoint: './dist/index.js',
@@ -369,12 +375,12 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
             }
         ],
         database: null,
-        healthCheck: null
+        healthCheck: 'probeVisionHealth'
     },
     {
         name: '@siduri-x/voice',
         organType: 'voice',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Voice (VOICEVOX Speech Synthesis)',
         description: 'Queued speech synthesis and audio rendering lifecycle adapter',
         entrypoint: './dist/index.js',
@@ -449,7 +455,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/mouth',
         organType: 'mouth',
-        version: '2.0.0',
+        version: '2.0.1',
         displayName: 'Mouth (Communication & UI Delivery)',
         description: 'Decoupled output delivery organ formatting cognitive decisions for web interfaces',
         entrypoint: './dist/index.js',

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

@@ -14,20 +14,20 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
     const cleanMachineRoot = node_path_1.default.resolve(__dirname, '../temp-clean-machine-e2e');
     const getPkgVer = (dir) => JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.resolve(repoRoot, dir, 'package.json'), 'utf8')).version;
     const ALL_CANONICAL_PACKAGES = [
-        { filter: '@siduri-x/core', tarName: `siduri-x-core-${getPkgVer('packages/core')}.tgz`, isOrgan: false },
-        { filter: '@siduri-x/brain', tarName: `siduri-x-brain-${getPkgVer('packages/organs/brain')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/memory', tarName: `siduri-x-memory-${getPkgVer('packages/memory')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/knowledge', tarName: `siduri-x-knowledge-${getPkgVer('packages/knowledge')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/self', tarName: `siduri-x-self-${getPkgVer('packages/self')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/ear', tarName: `siduri-x-ear-${getPkgVer('packages/organs/ear')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/vision', tarName: `siduri-x-vision-${getPkgVer('packages/organs/vision')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/hands', tarName: `siduri-x-hands-${getPkgVer('packages/organs/hands')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/body', tarName: `siduri-x-body-${getPkgVer('packages/organs/body')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/voice', tarName: `siduri-x-voice-${getPkgVer('packages/organs/voice')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/observation', tarName: `siduri-x-observation-${getPkgVer('packages/organs/observation')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/mouth', tarName: `siduri-x-mouth-${getPkgVer('packages/organs/mouth')}.tgz`, isOrgan: true },
-        { filter: '@siduri-x/eknowledge', tarName: `siduri-x-eknowledge-${getPkgVer('packages/organs/eknowledge')}.tgz`, isOrgan: true },
-        { filter: '@vxnus/siduri', tarName: `vxnus-siduri-${getPkgVer('cli')}.tgz`, isOrgan: false },
+        { filter: '@siduri-x/core', dir: 'packages/core', tarName: `siduri-x-core-${getPkgVer('packages/core')}.tgz`, isOrgan: false },
+        { filter: '@siduri-x/brain', dir: 'packages/organs/brain', tarName: `siduri-x-brain-${getPkgVer('packages/organs/brain')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/memory', dir: 'packages/memory', tarName: `siduri-x-memory-${getPkgVer('packages/memory')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/knowledge', dir: 'packages/knowledge', tarName: `siduri-x-knowledge-${getPkgVer('packages/knowledge')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/self', dir: 'packages/self', tarName: `siduri-x-self-${getPkgVer('packages/self')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/ear', dir: 'packages/organs/ear', tarName: `siduri-x-ear-${getPkgVer('packages/organs/ear')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/vision', dir: 'packages/organs/vision', tarName: `siduri-x-vision-${getPkgVer('packages/organs/vision')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/hands', dir: 'packages/organs/hands', tarName: `siduri-x-hands-${getPkgVer('packages/organs/hands')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/body', dir: 'packages/organs/body', tarName: `siduri-x-body-${getPkgVer('packages/organs/body')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/voice', dir: 'packages/organs/voice', tarName: `siduri-x-voice-${getPkgVer('packages/organs/voice')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/observation', dir: 'packages/organs/observation', tarName: `siduri-x-observation-${getPkgVer('packages/organs/observation')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/mouth', dir: 'packages/organs/mouth', tarName: `siduri-x-mouth-${getPkgVer('packages/organs/mouth')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/eknowledge', dir: 'packages/organs/eknowledge', tarName: `siduri-x-eknowledge-${getPkgVer('packages/organs/eknowledge')}.tgz`, isOrgan: true },
+        { filter: '@vxnus/siduri', dir: 'cli', tarName: `vxnus-siduri-${getPkgVer('cli')}.tgz`, isOrgan: false },
     ];
     const getTarPath = (pkgName) => {
         const pkg = ALL_CANONICAL_PACKAGES.find(p => p.filter === pkgName);
@@ -45,8 +45,8 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
         (0, node_child_process_1.execSync)("pnpm turbo run build --filter='!web'", { cwd: repoRoot, stdio: 'pipe' });
         // 3. Pack each canonical package into tempPackDir
         for (const pkg of ALL_CANONICAL_PACKAGES) {
-            (0, node_child_process_1.execSync)(`pnpm --filter ${pkg.filter} pack --pack-destination ${tempPackDir}`, {
-                cwd: repoRoot,
+            (0, node_child_process_1.execSync)(`pnpm pack --pack-destination ${tempPackDir}`, {
+                cwd: node_path_1.default.resolve(repoRoot, pkg.dir),
                 stdio: 'pipe',
             });
         }

package/dist/clean-machine-smoke.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const discovery_1 = require("./discovery");
+const generator_1 = require("./generator");
+describe('Phase 5: Clean-Machine Distribution & Packaging Smoke Suite', () => {
+    const repoRoot = node_path_1.default.resolve(__dirname, '../../');
+    const tempPackDir = node_path_1.default.resolve(__dirname, '../temp-packs-smoke');
+    const cleanMachineRoot = node_path_1.default.resolve(__dirname, '../temp-clean-machine-smoke');
+    const getPkgVer = (dir) => JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.resolve(repoRoot, dir, 'package.json'), 'utf8')).version;
+    const ALL_CANONICAL_PACKAGES = [
+        { filter: '@siduri-x/core', dir: 'packages/core', tarName: `siduri-x-core-${getPkgVer('packages/core')}.tgz`, isOrgan: false },
+        { filter: '@siduri-x/brain', dir: 'packages/organs/brain', tarName: `siduri-x-brain-${getPkgVer('packages/organs/brain')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/memory', dir: 'packages/memory', tarName: `siduri-x-memory-${getPkgVer('packages/memory')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/knowledge', dir: 'packages/knowledge', tarName: `siduri-x-knowledge-${getPkgVer('packages/knowledge')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/self', dir: 'packages/self', tarName: `siduri-x-self-${getPkgVer('packages/self')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/ear', dir: 'packages/organs/ear', tarName: `siduri-x-ear-${getPkgVer('packages/organs/ear')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/vision', dir: 'packages/organs/vision', tarName: `siduri-x-vision-${getPkgVer('packages/organs/vision')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/hands', dir: 'packages/organs/hands', tarName: `siduri-x-hands-${getPkgVer('packages/organs/hands')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/body', dir: 'packages/organs/body', tarName: `siduri-x-body-${getPkgVer('packages/organs/body')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/voice', dir: 'packages/organs/voice', tarName: `siduri-x-voice-${getPkgVer('packages/organs/voice')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/observation', dir: 'packages/organs/observation', tarName: `siduri-x-observation-${getPkgVer('packages/organs/observation')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/mouth', dir: 'packages/organs/mouth', tarName: `siduri-x-mouth-${getPkgVer('packages/organs/mouth')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/eknowledge', dir: 'packages/organs/eknowledge', tarName: `siduri-x-eknowledge-${getPkgVer('packages/organs/eknowledge')}.tgz`, isOrgan: true },
+        { filter: '@vxnus/siduri', dir: 'cli', tarName: `vxnus-siduri-${getPkgVer('cli')}.tgz`, isOrgan: false },
+    ];
+    const getTarPath = (pkgName) => {
+        const pkg = ALL_CANONICAL_PACKAGES.find(p => p.filter === pkgName);
+        return node_path_1.default.join(tempPackDir, pkg.tarName);
+    };
+    beforeAll(() => {
+        // 1. Prepare clean directories
+        if (node_fs_1.default.existsSync(tempPackDir))
+            node_fs_1.default.rmSync(tempPackDir, { recursive: true, force: true });
+        if (node_fs_1.default.existsSync(cleanMachineRoot))
+            node_fs_1.default.rmSync(cleanMachineRoot, { recursive: true, force: true });
+        node_fs_1.default.mkdirSync(tempPackDir, { recursive: true });
+        node_fs_1.default.mkdirSync(cleanMachineRoot, { recursive: true });
+        // 2. Build all packages in repo
+        (0, node_child_process_1.execSync)("pnpm turbo run build --filter='!web'", { cwd: repoRoot, stdio: 'pipe' });
+        // 3. Pack each canonical package into tempPackDir
+        for (const pkg of ALL_CANONICAL_PACKAGES) {
+            (0, node_child_process_1.execSync)(`pnpm pack --pack-destination ${tempPackDir}`, {
+                cwd: node_path_1.default.resolve(repoRoot, pkg.dir),
+                stdio: 'pipe',
+            });
+        }
+    }, 90000);
+    afterAll(() => {
+        if (node_fs_1.default.existsSync(tempPackDir))
+            node_fs_1.default.rmSync(tempPackDir, { recursive: true, force: true });
+        if (node_fs_1.default.existsSync(cleanMachineRoot))
+            node_fs_1.default.rmSync(cleanMachineRoot, { recursive: true, force: true });
+    });
+    describe('Phase 5A: Package Artifact Verification', () => {
+        test('all 14 packages produce valid tarballs', () => {
+            for (const pkg of ALL_CANONICAL_PACKAGES) {
+                const tarPath = node_path_1.default.join(tempPackDir, pkg.tarName);
+                expect(node_fs_1.default.existsSync(tarPath)).toBe(true);
+            }
+        });
+        test('packed package.json files have zero workspace:* or link: dependencies', () => {
+            for (const pkg of ALL_CANONICAL_PACKAGES) {
+                const tarPath = node_path_1.default.join(tempPackDir, pkg.tarName);
+                const pkgJsonRaw = (0, node_child_process_1.execSync)(`tar -xzf ${tarPath} -O package/package.json`, { encoding: 'utf8' });
+                const pkgJson = JSON.parse(pkgJsonRaw);
+                const allDeps = {
+                    ...(pkgJson.dependencies || {}),
+                    ...(pkgJson.peerDependencies || {}),
+                };
+                for (const [depName, version] of Object.entries(allDeps)) {
+                    if (typeof version === 'string') {
+                        expect(version.startsWith('workspace:')).toBe(false);
+                        expect(version.startsWith('link:')).toBe(false);
+                        expect(version.includes('../')).toBe(false);
+                    }
+                }
+            }
+        });
+    });
+    describe('Phase 5B & 5C & 5G: Clean-Machine Installation & Isolation Acceptance', () => {
+        const registry = discovery_1.OrganRegistry.discover([
+            node_path_1.default.resolve(repoRoot, 'packages/organs'),
+            node_path_1.default.resolve(repoRoot, 'packages')
+        ]);
+        const brain = registry.get('brain');
+        const hands = registry.get('hands');
+        const memory = registry.get('memory');
+        test('Clean Composition 1: Brain only instance installs, starts, runs doctor and db push', () => {
+            const instanceDir = node_path_1.default.join(cleanMachineRoot, 'inst-brain-only');
+            node_fs_1.default.mkdirSync(node_path_1.default.join(instanceDir, 'src'), { recursive: true });
+            const files = (0, generator_1.generateInstanceFiles)({
+                name: 'CleanBrainOnly',
+                selectedManifests: [brain],
+            });
+            const pkgObj = JSON.parse(files['package.json']);
+            pkgObj.dependencies = {
+                '@siduri-x/core': `file:${getTarPath('@siduri-x/core')}`,
+                '@siduri-x/brain': `file:${getTarPath('@siduri-x/brain')}`,
+            };
+            pkgObj.devDependencies = {
+                '@vxnus/siduri': `file:${getTarPath('@vxnus/siduri')}`,
+            };
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'package.json'), JSON.stringify(pkgObj, null, 2) + '\n');
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.config.json'), files['siduri.config.json']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.schema.json'), files['siduri.schema.json']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, '.env.example'), files['.env.example']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'README.md'), files['README.md']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'src/index.js'), files['src/index.js']);
+            (0, node_child_process_1.execSync)('npm install --no-audit --no-fund', { cwd: instanceDir, stdio: 'pipe' });
+            expect(node_fs_1.default.existsSync(node_path_1.default.join(instanceDir, 'node_modules/@siduri-x/memory'))).toBe(false);
+            expect(node_fs_1.default.existsSync(node_path_1.default.join(instanceDir, 'node_modules/@siduri-x/hands'))).toBe(false);
+            const doctorPass = (0, node_child_process_1.execSync)(`node ${node_path_1.default.resolve(repoRoot, 'cli/dist/index.js')} doctor`, {
+                cwd: instanceDir,
+                env: { ...process.env, OPENROUTER_API_KEY: 'test-key-clean' },
+                encoding: 'utf8',
+            });
+            expect(doctorPass).toContain('Result: PASS');
+            const dbPushOutput = (0, node_child_process_1.execSync)(`node ${node_path_1.default.resolve(repoRoot, 'cli/dist/index.js')} db push`, {
+                cwd: instanceDir,
+                encoding: 'utf8',
+            });
+            expect(dbPushOutput).toContain('SQLite manages schema natively. No CLI migrations required.');
+        }, 60000);
+        test('Clean Composition 2: Brain + Hands installs and runs doctor verifying ACTION_POLICY_SECRET', () => {
+            const instanceDir = node_path_1.default.join(cleanMachineRoot, 'inst-brain-hands');
+            node_fs_1.default.mkdirSync(node_path_1.default.join(instanceDir, 'src'), { recursive: true });
+            const files = (0, generator_1.generateInstanceFiles)({
+                name: 'CleanBrainHands',
+                selectedManifests: [brain, hands],
+            });
+            const pkgObj = JSON.parse(files['package.json']);
+            pkgObj.dependencies = {
+                '@siduri-x/core': `file:${getTarPath('@siduri-x/core')}`,
+                '@siduri-x/brain': `file:${getTarPath('@siduri-x/brain')}`,
+                '@siduri-x/hands': `file:${getTarPath('@siduri-x/hands')}`,
+            };
+            pkgObj.devDependencies = {
+                '@vxnus/siduri': `file:${getTarPath('@vxnus/siduri')}`,
+            };
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'package.json'), JSON.stringify(pkgObj, null, 2) + '\n');
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.config.json'), files['siduri.config.json']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.schema.json'), files['siduri.schema.json']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, '.env.example'), files['.env.example']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'README.md'), files['README.md']);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'src/index.js'), files['src/index.js']);
+            (0, node_child_process_1.execSync)('npm install --no-audit --no-fund', { cwd: instanceDir, stdio: 'pipe' });
+            const doctorOutput = (0, node_child_process_1.execSync)(`node ${node_path_1.default.resolve(repoRoot, 'cli/dist/index.js')} doctor`, {
+                cwd: instanceDir,
+                env: {
+                    ...process.env,
+                    OPENROUTER_API_KEY: 'test-key-clean',
+                    ACTION_POLICY_SECRET: 'test-secret-clean',
+                },
+                encoding: 'utf8',
+            });
+            expect(doctorOutput).toContain('ACTION_POLICY_SECRET');
+            expect(doctorOutput).toContain('Result: PASS');
+        }, 60000);
+    });
+});