vgxness 1.20.4 → 1.20.6

package/dist/setup/providers/claude-setup-adapter.js

@@ -1,6 +1,6 @@
-import { planClaudeCodeMcpInstall } from '../../mcp/client-install-claude-code-contract.js';
+import { planClaudeCodeMcpInstall } from '../../adapters/claude/install/client-install-claude-code-contract.js';
 import { createMcpClientSetupPreview } from '../../mcp/client-setup-preview.js';
-import { externalProviderWriteSafety, noWriteActionSafety } from './provider-setup-adapter.js';
+import { externalProviderWriteSafety, noWriteActionSafety, } from './provider-setup-adapter.js';
 export const claudeSetupAdapter = {
     id: 'claude',
     displayName: 'Claude',
@@ -10,7 +10,12 @@ export const claudeSetupAdapter = {
         { kind: 'user-config', label: 'Managed user-global Claude MCP config', path: '~/.claude.json', writableBySetup: false },
         { kind: 'user-config', label: 'Managed user-global Claude agents', path: '~/.claude/agents/*.md', writableBySetup: false },
         { kind: 'user-config', label: 'Managed user-global Claude memory', path: '~/.claude/CLAUDE.md', writableBySetup: false },
-        { kind: 'project-config', label: 'Project Claude files (external/manual diagnostic only)', path: '.mcp.json, .claude/agents/*.md, CLAUDE.md', writableBySetup: false },
+        {
+            kind: 'project-config',
+            label: 'Project Claude files (external/manual diagnostic only)',
+            path: '.mcp.json, .claude/agents/*.md, CLAUDE.md',
+            writableBySetup: false,
+        },
     ],
     getStatus(context) {
         const plan = this.getInstallPlan?.(context);
@@ -21,7 +26,9 @@ export const claudeSetupAdapter = {
             evidence: context.databasePath !== undefined
                 ? ['Claude MCP preview can be generated from the selected database path.']
                 : ['Claude MCP preview uses a placeholder until a database path is selected.'],
-            guidance: ['VGXNESS will manage user-global provider configuration. Use `vgxness mcp install claude --yes --run-id <id>` for explicit guarded apply. Project-local provider files are external/manual diagnostics and will not be modified. Read-only setup/status surfaces do not execute Claude Code.'],
+            guidance: [
+                'VGXNESS will manage user-global provider configuration. Use `vgxness mcp install claude --yes --run-id <id>` for explicit guarded apply. Project-local provider files are external/manual diagnostics and will not be modified. Read-only setup/status surfaces do not execute Claude Code.',
+            ],
             actions: [
                 {
                     id: 'claude-manual-guidance',

package/dist/setup/providers/opencode-setup-adapter.js

@@ -1,6 +1,6 @@
-import { planOpenCodeMcpInstall } from '../../mcp/client-install-opencode-contract.js';
+import { planOpenCodeMcpInstall } from '../../adapters/opencode/install/client-install-opencode-contract.js';
+import { createOpenCodeMcpVisibilityReport } from '../../adapters/opencode/install/opencode-visibility.js';
 import { createMcpClientSetupPreview } from '../../mcp/client-setup-preview.js';
-import { createOpenCodeMcpVisibilityReport } from '../../mcp/opencode-visibility.js';
 import { externalProviderWriteSafety, noWriteActionSafety, } from './provider-setup-adapter.js';
 export const openCodeSetupAdapter = {
     id: 'opencode',
@@ -17,11 +17,11 @@ export const openCodeSetupAdapter = {
         return {
             providerId: 'opencode',
             status: visibility?.ready === true ? 'ready' : 'available',
-            summary: visibility?.ready === true
-                ? 'OpenCode MCP visibility is ready.'
-                : 'OpenCode provider setup is available; install/apply remains external and explicit.',
+            summary: visibility?.ready === true ? 'OpenCode MCP visibility is ready.' : 'OpenCode provider setup is available; install/apply remains external and explicit.',
             evidence: visibility?.evidence ?? ['OpenCode setup preview and install planning are available.'],
-            guidance: visibility?.guidance ?? ['VGXNESS will manage user-global provider configuration. Project-local provider files are external/manual diagnostics and will not be modified.'],
+            guidance: visibility?.guidance ?? [
+                'VGXNESS will manage user-global provider configuration. Project-local provider files are external/manual diagnostics and will not be modified.',
+            ],
             actions: plan?.actions ?? [],
             ...previewField(openCodePlanPreview(visibility, plan)),
         };
@@ -122,7 +122,10 @@ function openCodePlanPreview(visibility, plan) {
             targetPath: source.targetPath,
             backupRequired: source.backupRequired,
             confirmationRequired: Boolean(plan?.actions.some((candidate) => candidate.safety.requiresExplicitConfirmation)),
-            risks: [...(source.overwriteVgxness ? overwriteInstallRisks(source.installsAgents) : source.action === 'create' ? createInstallRisks() : mergeInstallRisks()), ...bashPermissionRisks(source.bashPermissionPolicy)],
+            risks: [
+                ...(source.overwriteVgxness ? overwriteInstallRisks(source.installsAgents) : source.action === 'create' ? createInstallRisks() : mergeInstallRisks()),
+                ...bashPermissionRisks(source.bashPermissionPolicy),
+            ],
             warnings: source.warnings,
         };
     }

package/dist/setup/setup-plan.js

@@ -1,6 +1,6 @@
 import { join, resolve } from 'node:path';
-import { planClaudeCodeMcpInstall } from '../mcp/client-install-claude-code-contract.js';
-import { planOpenCodeMcpInstall } from '../mcp/client-install-opencode-contract.js';
+import { planClaudeCodeMcpInstall } from '../adapters/claude/install/client-install-claude-code-contract.js';
+import { planOpenCodeMcpInstall, } from '../adapters/opencode/install/client-install-opencode-contract.js';
 import { resolveMemoryDatabasePath } from '../memory/storage-paths.js';
 import { vgxnessSetupDefaults } from './setup-defaults.js';
 export function createSetupPlan(input) {
@@ -69,7 +69,9 @@ export function createSetupPlan(input) {
                             severity: 'blocking',
                             message: claude.message,
                             targetPath,
-                            recovery: claude.reason === 'malformed_claude_project_memory' || claude.reason === 'conflicting_claude_project_memory' ? 'Manually reconcile the VGXNESS markers in user-global ~/.claude/CLAUDE.md, then rerun `vgxness setup plan --provider claude`.' : 'Inspect the Claude user-global config, resolve the conflict, then rerun `vgxness setup plan --provider claude`.',
+                            recovery: claude.reason === 'malformed_claude_project_memory' || claude.reason === 'conflicting_claude_project_memory'
+                                ? 'Manually reconcile the VGXNESS markers in user-global ~/.claude/CLAUDE.md, then rerun `vgxness setup plan --provider claude`.'
+                                : 'Inspect the Claude user-global config, resolve the conflict, then rerun `vgxness setup plan --provider claude`.',
                         },
                     ],
                     backupsPlanned: [],
@@ -95,12 +97,19 @@ export function createSetupPlan(input) {
                 ],
                 conflicts: [],
                 backupsPlanned: claude.targets
-                    .filter((target) => target.kind !== 'cli-mcp-registration' && ((target.kind === 'user-memory' && target.backupRequired) || target.action === 'merge' || target.action === 'update-vgxness'))
+                    .filter((target) => target.kind !== 'cli-mcp-registration' &&
+                    ((target.kind === 'user-memory' && target.backupRequired) || target.action === 'merge' || target.action === 'update-vgxness'))
                     .map((target) => ({
                     targetPath: target.path,
-                    reason: target.kind === 'user-memory' ? 'A future guarded Claude apply would create a managed VGXNESS backup before appending or updating the user-global ~/.claude/CLAUDE.md managed block.' : 'A future guarded Claude apply would create a managed VGXNESS backup before merging or updating Claude user-global configuration.',
+                    reason: target.kind === 'user-memory'
+                        ? 'A future guarded Claude apply would create a managed VGXNESS backup before appending or updating the user-global ~/.claude/CLAUDE.md managed block.'
+                        : 'A future guarded Claude apply would create a managed VGXNESS backup before merging or updating Claude user-global configuration.',
                 })),
-                nextCommands: ['vgxness mcp install claude --plan', 'vgxness mcp install claude --yes --run-id <id>', 'OpenCode remains the default guided setup provider.'],
+                nextCommands: [
+                    'vgxness mcp install claude --plan',
+                    'vgxness mcp install claude --yes --run-id <id>',
+                    'OpenCode remains the default guided setup provider.',
+                ],
             },
         };
     }
@@ -183,7 +192,11 @@ function setupPlanFromOpenCode(input) {
                 },
             ]
             : [],
-        nextCommands: [input.opencode.overwriteVgxness ? 'vgxness setup reinstall --yes' : 'vgxness setup apply --yes', 'vgxness doctor', 'Restart OpenCode and verify the vgxness MCP server is visible.'],
+        nextCommands: [
+            input.opencode.overwriteVgxness ? 'vgxness setup reinstall --yes' : 'vgxness setup apply --yes',
+            'vgxness doctor',
+            'Restart OpenCode and verify the vgxness MCP server is visible.',
+        ],
     };
 }
 function bashPermissionDescription(policy) {

package/dist/skills/boot-seed.js

@@ -1,42 +1 @@
-import { SkillSeedService } from './skill-seed-service.js';
-const skipEnvVar = 'VGXNESS_SKIP_SKILL_SEED_AUTO_UPGRADE';
-export function runBootSkillSeed(database, env = process.env) {
-    if (isOptOut(env))
-        return okFromSeedResult({ skipped: true });
-    const seeded = new SkillSeedService(database).seedFromDefaultManifest();
-    if (!seeded.ok)
-        return seeded;
-    return okFromSeedResult({ skipped: false, seed: seeded.value });
-}
-function isOptOut(env) {
-    const value = env[skipEnvVar];
-    return value === '1' || value === 'true';
-}
-function okFromSeedResult(input) {
-    if (input.skipped) {
-        return {
-            ok: true,
-            value: {
-                skipped: true,
-                skillsCreated: 0,
-                skillsUpdated: 0,
-                versionsCreated: 0,
-                versionsSkipped: 0,
-                attachmentsCreated: 0,
-                attachmentsSkipped: 0,
-            },
-        };
-    }
-    return {
-        ok: true,
-        value: {
-            skipped: false,
-            skillsCreated: input.seed.skillsCreated,
-            skillsUpdated: input.seed.skillsUpdated,
-            versionsCreated: input.seed.versionsCreated,
-            versionsSkipped: input.seed.versionsSkipped,
-            attachmentsCreated: input.seed.attachmentsCreated,
-            attachmentsSkipped: input.seed.attachmentsSkipped,
-        },
-    };
-}
+export * from '../application/skills/boot-seed.js';

package/dist/skills/personal-skills.js

@@ -1,41 +1 @@
-export const GLOBAL_PERSONAL_SKILLS_PROJECT = '__personal__';
-export const GLOBAL_VGXNESS_SKILLS_PROJECT = '__vgxness__';
-export const skillLookupContexts = (project, scope) => {
-    const contexts = [{ project, scope }];
-    if (scope !== 'personal')
-        contexts.push({ project, scope: 'personal' });
-    if (project !== GLOBAL_PERSONAL_SKILLS_PROJECT)
-        contexts.push({
-            project: GLOBAL_PERSONAL_SKILLS_PROJECT,
-            scope: 'personal',
-        });
-    if (project !== GLOBAL_VGXNESS_SKILLS_PROJECT)
-        contexts.push({ project: GLOBAL_VGXNESS_SKILLS_PROJECT, scope: 'project' });
-    return dedupeContexts(contexts);
-};
-export const skillIndexContexts = (project, scope) => {
-    if (scope === 'personal')
-        return skillLookupContexts(project, 'personal');
-    return skillLookupContexts(project, scope);
-};
-export const dedupeSkillSummariesByName = (skills) => {
-    const seen = new Set();
-    const deduped = [];
-    for (const skill of skills) {
-        if (seen.has(skill.name))
-            continue;
-        seen.add(skill.name);
-        deduped.push(skill);
-    }
-    return deduped;
-};
-export const dedupeContexts = (contexts) => {
-    const seen = new Set();
-    return contexts.filter((context) => {
-        const key = `${context.project}:${context.scope}`;
-        if (seen.has(key))
-            return false;
-        seen.add(key);
-        return true;
-    });
-};
+export * from '../application/skills/personal-skills.js';

package/dist/skills/repositories/skill-evaluation-requests.js

@@ -1,190 +1 @@
-import { randomUUID } from 'node:crypto';
-export class SkillEvaluationRequestRepository {
-    db;
-    constructor(db) {
-        this.db = db;
-    }
-    create(input) {
-        const validation = validateCreateInput(input);
-        if (!validation.ok)
-            return validation;
-        const result = this.db.transaction(() => {
-            assertSkillInScope(this.db, input.skillId, input.project, input.scope);
-            if (input.versionId !== undefined)
-                assertVersionBelongsToSkill(this.db, input.versionId, input.skillId);
-            if (input.scenarioId !== undefined)
-                assertScenarioBelongsToSkill(this.db, input.scenarioId, input.skillId);
-            if (input.proposalId !== undefined)
-                assertProposalBelongsToSkill(this.db, input.proposalId, input.skillId);
-            const now = new Date().toISOString();
-            const id = randomUUID();
-            this.db.connection
-                .prepare(`
-          INSERT INTO skill_evaluation_requests(
-            id, project, scope, skill_id, version_id, scenario_id, proposal_id,
-            status, requested_by, run_id, agent_id, workflow, phase, provider_adapter,
-            risk_json, preflight_json, created_at, updated_at
-          ) VALUES (
-            @id, @project, @scope, @skillId, @versionId, @scenarioId, @proposalId,
-            'requested', @requestedBy, @runId, @agentId, @workflow, @phase, @providerAdapter,
-            @riskJson, @preflightJson, @createdAt, @updatedAt
-          )
-        `)
-                .run({
-                id,
-                project: input.project,
-                scope: input.scope,
-                skillId: input.skillId,
-                versionId: input.versionId ?? null,
-                scenarioId: input.scenarioId ?? null,
-                proposalId: input.proposalId ?? null,
-                requestedBy: input.requestedBy.trim(),
-                runId: input.runId ?? null,
-                agentId: input.agentId ?? null,
-                workflow: input.workflow ?? null,
-                phase: input.phase ?? null,
-                providerAdapter: input.providerAdapter ?? null,
-                riskJson: input.risk === undefined ? null : JSON.stringify(input.risk),
-                preflightJson: input.preflight === undefined ? null : JSON.stringify(input.preflight),
-                createdAt: now,
-                updatedAt: now,
-            });
-            const read = this.getById(id);
-            if (!read.ok)
-                throw new Error(read.error.message);
-            return read.value;
-        });
-        if (!result.ok && result.error.cause instanceof SkillEvaluationRequestValidationError)
-            return validationFailure(result.error.cause.message);
-        return result;
-    }
-    list(filters) {
-        try {
-            const where = ['project=@project', 'scope=@scope'];
-            const parameters = { project: filters.project, scope: filters.scope, limit: filters.limit ?? 25 };
-            addOptionalFilter(where, parameters, 'skill_id', 'skillId', filters.skillId);
-            addOptionalFilter(where, parameters, 'version_id', 'versionId', filters.versionId);
-            addOptionalFilter(where, parameters, 'scenario_id', 'scenarioId', filters.scenarioId);
-            addOptionalFilter(where, parameters, 'proposal_id', 'proposalId', filters.proposalId);
-            addOptionalFilter(where, parameters, 'status', 'status', filters.status);
-            addOptionalFilter(where, parameters, 'run_id', 'runId', filters.runId);
-            addOptionalFilter(where, parameters, 'agent_id', 'agentId', filters.agentId);
-            const rows = this.db.connection
-                .prepare(`
-          SELECT * FROM skill_evaluation_requests
-          WHERE ${where.join(' AND ')}
-          ORDER BY created_at DESC, rowid DESC
-          LIMIT @limit
-        `)
-                .all(parameters);
-            return ok(rows.map(mapRequest));
-        }
-        catch (cause) {
-            return fail('Failed to list skill evaluation requests', cause);
-        }
-    }
-    getById(id) {
-        try {
-            const row = this.db.connection.prepare('SELECT * FROM skill_evaluation_requests WHERE id=?').get(id);
-            return row ? ok(mapRequest(row)) : missing(`Skill evaluation request not found: ${id}`);
-        }
-        catch (cause) {
-            return fail('Failed to read skill evaluation request', cause);
-        }
-    }
-}
-function validateCreateInput(input) {
-    if (!input.project.trim())
-        return validationFailure('Project is required');
-    if (input.scope !== 'project' && input.scope !== 'personal')
-        return validationFailure('Scope must be project or personal');
-    if (!input.skillId.trim())
-        return validationFailure('Skill id is required');
-    if (!input.requestedBy.trim())
-        return validationFailure('Skill evaluation requester is required');
-    return ok(undefined);
-}
-function addOptionalFilter(where, parameters, column, key, value) {
-    if (value === undefined)
-        return;
-    where.push(`${column}=@${key}`);
-    parameters[key] = value;
-}
-function assertSkillInScope(db, skillId, project, scope) {
-    const row = db.connection.prepare('SELECT project, scope FROM skills WHERE id=?').get(skillId);
-    if (row === undefined)
-        throw new SkillEvaluationRequestValidationError(`Skill not found: ${skillId}`);
-    if (row.project !== project || row.scope !== scope)
-        throw new SkillEvaluationRequestValidationError('Skill does not belong to the requested project/scope');
-}
-function assertVersionBelongsToSkill(db, versionId, skillId) {
-    const row = db.connection.prepare('SELECT skill_id FROM skill_versions WHERE id=?').get(versionId);
-    if (row === undefined)
-        throw new SkillEvaluationRequestValidationError(`Skill version not found: ${versionId}`);
-    if (row.skill_id !== skillId)
-        throw new SkillEvaluationRequestValidationError('Skill version must belong to the evaluated skill');
-}
-function assertScenarioBelongsToSkill(db, scenarioId, skillId) {
-    const row = db.connection.prepare('SELECT skill_id FROM skill_evaluation_scenarios WHERE id=?').get(scenarioId);
-    if (row === undefined)
-        throw new SkillEvaluationRequestValidationError(`Skill evaluation scenario not found: ${scenarioId}`);
-    if (row.skill_id !== skillId)
-        throw new SkillEvaluationRequestValidationError('Skill evaluation scenario must belong to the evaluated skill');
-}
-function assertProposalBelongsToSkill(db, proposalId, skillId) {
-    const row = db.connection.prepare('SELECT skill_id FROM skill_improvement_proposals WHERE id=?').get(proposalId);
-    if (row === undefined)
-        throw new SkillEvaluationRequestValidationError(`Skill improvement proposal not found: ${proposalId}`);
-    if (row.skill_id !== skillId)
-        throw new SkillEvaluationRequestValidationError('Skill improvement proposal must belong to the evaluated skill');
-}
-function mapRequest(row) {
-    const request = {
-        id: row.id,
-        project: row.project,
-        scope: row.scope,
-        skillId: row.skill_id,
-        status: row.status,
-        requestedBy: row.requested_by,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-    };
-    if (row.version_id !== null)
-        request.versionId = row.version_id;
-    if (row.scenario_id !== null)
-        request.scenarioId = row.scenario_id;
-    if (row.proposal_id !== null)
-        request.proposalId = row.proposal_id;
-    if (row.run_id !== null)
-        request.runId = row.run_id;
-    if (row.agent_id !== null)
-        request.agentId = row.agent_id;
-    if (row.workflow !== null)
-        request.workflow = row.workflow;
-    if (row.phase !== null)
-        request.phase = row.phase;
-    if (row.provider_adapter !== null)
-        request.providerAdapter = row.provider_adapter;
-    if (row.risk_json !== null)
-        request.risk = JSON.parse(row.risk_json);
-    if (row.preflight_json !== null)
-        request.preflight = JSON.parse(row.preflight_json);
-    return request;
-}
-function ok(value) {
-    return { ok: true, value };
-}
-function missing(message) {
-    return { ok: false, error: { code: 'not_found', message } };
-}
-function validationFailure(message) {
-    return { ok: false, error: { code: 'validation_failed', message } };
-}
-function fail(message, cause) {
-    const error = { code: 'validation_failed', message };
-    if (cause !== undefined)
-        error.cause = cause;
-    return { ok: false, error };
-}
-class SkillEvaluationRequestValidationError extends Error {
-}
+export * from '../../storage/skills/repositories/skill-evaluation-requests.js';