dsh-env-manager-plugin 0.0.0-stage → 0.1.1

package/lib/domain/types.d.ts

@@ -0,0 +1,412 @@
+export type RecordKind = 'environment' | 'service' | 'deployment' | 'ruleProfile' | 'operationBinding';
+export type RuntimeMode = 'native' | 'docker' | 'kubernetes';
+export type EnvironmentCategory = 'dev' | 'test' | 'staging' | 'production' | 'custom';
+export type Status = 'configured-not-verified' | 'partially-verified' | 'verified';
+export type Severity = 'info' | 'warning' | 'error';
+export type MatchLevel = 'deployment' | 'environment-service' | 'service' | 'category-mode' | 'global';
+export type Actor = 'agent' | 'ui';
+export interface Diagnostic {
+    code: string;
+    severity: Severity;
+    message: string;
+    file?: string;
+    path?: string;
+    details?: Record<string, unknown>;
+}
+export interface RecordMeta {
+    id: string;
+    schemaVersion: 1;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LogicalRole {
+    id: string;
+    name: string;
+    description?: string;
+}
+export type HostKind = 'vm' | 'physical' | 'k8s-all-in-one' | 'k8s-worker' | 'pod-host';
+export type HostAccessMethod = 'ssh' | 'kubectl' | 'docker';
+export type ClusterTopology = 'all-in-one' | 'separate' | 'external';
+export interface Host {
+    id: string;
+    name: string;
+    kind?: HostKind;
+    os?: string;
+    platform?: string;
+    ip?: string;
+    publicIp?: string;
+    sshPort?: number;
+    roles: string[];
+    access?: HostAccessMethod[];
+    clusterRef?: string;
+    adminUser?: string;
+    isActive?: boolean;
+    credentialRef?: string;
+    accounts?: HostAccount[];
+    note?: string;
+}
+export type LoginProtocol = 'ssh' | 'rdp' | 'web' | 'k8s-api' | 'docker' | 'custom';
+export type LoginAuthType = 'password' | 'private-key' | 'agent' | 'token' | 'other';
+export interface HostAccount {
+    id: string;
+    username: string;
+    purpose?: string;
+    protocol?: LoginProtocol;
+    loginUrl?: string;
+    port?: number;
+    authType?: LoginAuthType;
+    credentialRef?: string;
+    lastLoginAt?: string;
+    lastLoginFrom?: string;
+    note?: string;
+}
+export type LoginResult = 'success' | 'failure';
+export interface LoginRecord {
+    id: string;
+    at: string;
+    username: string;
+    hostRef?: string;
+    accountId?: string;
+    protocol?: LoginProtocol;
+    sourceIp?: string;
+    result: LoginResult;
+    note?: string;
+}
+export interface Cluster {
+    id: string;
+    name: string;
+    kind: 'kubernetes' | 'docker';
+    topology?: ClusterTopology;
+    apiEndpoint?: string;
+    namespaces?: string[];
+    credentialRef?: string;
+    note?: string;
+}
+export interface AccessEndpoint {
+    id: string;
+    kind: 'ssh' | 'web' | 'k8s-api' | 'docker' | 'custom';
+    hostRef?: string;
+    clusterRef?: string;
+    url?: string;
+    port?: number;
+    credentialRef?: string;
+    note?: string;
+}
+export interface LogSourceFile {
+    kind: 'file';
+    path: string;
+}
+export interface LogSourceContainer {
+    kind: 'container-stdout';
+    container: string;
+}
+export interface LogSourcePod {
+    kind: 'pod-logs';
+    namespace: string;
+    workload: string;
+}
+export type LogSource = LogSourceFile | LogSourceContainer | LogSourcePod;
+export interface ClassLocation {
+    kind: 'build-output' | 'deployed-dir' | 'jar-entry';
+    path: string;
+    entryPrefix?: string;
+}
+export interface RuleOverride {
+    variables?: Record<string, string | number | boolean>;
+    paths?: Record<string, string>;
+    logSources?: Partial<Record<RuntimeMode, LogSource>>;
+    classLocations?: Partial<Record<RuntimeMode, ClassLocation>>;
+}
+export interface Environment extends RecordMeta {
+    name: string;
+    aliases: string[];
+    category: EnvironmentCategory;
+    description?: string;
+    roles: LogicalRole[];
+    hosts: Host[];
+    clusters: Cluster[];
+    endpoints: AccessEndpoint[];
+    loginRecords?: LoginRecord[];
+    ruleOverrides?: RuleOverride;
+}
+export interface GitInfo {
+    url: string;
+    defaultBranch: string;
+    modulePath?: string;
+}
+export interface BuildInfo {
+    tool: 'maven' | 'gradle' | 'npm' | 'custom';
+    command?: string;
+}
+export interface ArtifactInfo {
+    name: string;
+    path?: string;
+}
+export interface Service extends RecordMeta {
+    name: string;
+    aliases: string[];
+    category: string;
+    description?: string;
+    git: GitInfo;
+    build?: BuildInfo;
+    artifact?: ArtifactInfo;
+    deployModes: RuntimeMode[];
+    ruleProfileRefs: string[];
+}
+export interface NativeLocation {
+    kind: 'native';
+    hostRef: string;
+    installDir?: string;
+    serviceName?: string;
+    processMatch?: string;
+}
+export interface DockerLocation {
+    kind: 'docker';
+    hostRef: string;
+    containerName?: string;
+    image?: string;
+    volumes?: string[];
+}
+export interface KubernetesLocation {
+    kind: 'kubernetes';
+    clusterRef: string;
+    namespace: string;
+    workload: {
+        kind: 'Deployment' | 'StatefulSet' | 'DaemonSet' | 'CronJob' | 'Pod';
+        name: string;
+    };
+    container?: string;
+}
+export type DeploymentLocation = NativeLocation | DockerLocation | KubernetesLocation;
+export interface Deployment extends RecordMeta {
+    name?: string;
+    environmentId: string;
+    serviceId: string;
+    runtimeMode: RuntimeMode;
+    location: DeploymentLocation;
+    variables?: Record<string, string | number | boolean>;
+    ruleOverrides?: RuleOverride;
+}
+export interface RuleProfile extends RecordMeta {
+    name?: string;
+    description?: string;
+    variables?: Record<string, string | number | boolean>;
+    paths?: Record<string, string>;
+    logSources?: Partial<Record<RuntimeMode, LogSource>>;
+    classLocations?: Partial<Record<RuntimeMode, ClassLocation>>;
+}
+export interface SkillReference {
+    name: string;
+    expectedSource?: string | null;
+    expectedProvider?: string | null;
+}
+export interface OperationMatch {
+    environmentId?: string;
+    serviceId?: string;
+    deploymentId?: string;
+    deploymentMode?: RuntimeMode;
+    serviceCategory?: string;
+}
+export interface OperationPolicy {
+    requiresApproval: boolean;
+    allowProduction: boolean;
+}
+export interface OperationBinding extends RecordMeta {
+    operation: string;
+    match: OperationMatch;
+    skill: SkillReference;
+    parameters?: Record<string, string | number | boolean>;
+    policy: OperationPolicy;
+    enabled: boolean;
+}
+export type AnyRecord = Environment | Service | Deployment | RuleProfile | OperationBinding;
+export type RecordByKind = {
+    environment: Environment;
+    service: Service;
+    deployment: Deployment;
+    ruleProfile: RuleProfile;
+    operationBinding: OperationBinding;
+};
+export type RuleLayer = 'global' | 'service' | 'environment' | 'deployment';
+export interface RuleSource {
+    layer: RuleLayer;
+    ruleProfileId?: string;
+    recordId?: string;
+}
+export interface ProvenanceInput {
+    name: string;
+    source: RuleSource;
+}
+export interface ProvenanceEntry {
+    field: string;
+    definedBy: RuleSource;
+    inputs: ProvenanceInput[];
+    shadowed: RuleSource[];
+    value: string | number | boolean;
+}
+export interface ResolvedField<T> {
+    value: T;
+    provenance: ProvenanceEntry;
+}
+export interface ResolvedStructured<T> {
+    value: T;
+    provenance: ProvenanceEntry[];
+}
+export interface CredentialStatus {
+    ref: string;
+    configured: boolean;
+    source?: string;
+}
+export interface ServiceContext {
+    environmentId: string;
+    environmentName: string;
+    environmentCategory: EnvironmentCategory;
+    serviceId: string;
+    serviceName: string;
+    serviceCategory: string;
+    deploymentId: string;
+    deploymentName?: string;
+    runtimeMode: RuntimeMode;
+    source: {
+        gitUrl?: string;
+        defaultBranch?: string;
+        modulePath?: string;
+    };
+    artifact?: {
+        name: string;
+        path?: string;
+    };
+    location: DeploymentLocation;
+    variables: Record<string, ResolvedField<string | number | boolean>>;
+    paths: Record<string, ResolvedField<string>>;
+    logSource?: ResolvedStructured<LogSource>;
+    classLocation?: ResolvedStructured<ClassLocation>;
+    ruleProfiles: string[];
+    status: Status;
+    credentials: CredentialStatus[];
+    diagnostics: Diagnostic[];
+}
+export interface ResolvedSkillReference {
+    name: string;
+    source?: string | null;
+    provider?: string | null;
+    available: boolean | 'unknown';
+}
+export interface OperationResolution {
+    ok: boolean;
+    operation: string;
+    requested: {
+        environmentId: string;
+        serviceId?: string;
+        deploymentId?: string;
+    };
+    matchedBindingId?: string;
+    matchLevel?: MatchLevel;
+    skill?: ResolvedSkillReference;
+    parameters?: Record<string, string>;
+    policy?: OperationPolicy;
+    diagnostics: Diagnostic[];
+}
+export interface SessionContext {
+    sessionId: string;
+    defaultEnvironmentId: string | null;
+    persisted: boolean;
+}
+export interface RecordSummary {
+    kind: RecordKind;
+    id: string;
+    name: string;
+    summary?: string;
+}
+export interface ListResult {
+    items: RecordSummary[];
+    warnings: Diagnostic[];
+}
+export interface GetResult {
+    record: AnyRecord;
+    yaml: string;
+}
+export interface FindHit {
+    kind: RecordKind;
+    id: string;
+    name: string;
+    field: 'id' | 'name' | 'alias' | 'category';
+}
+export interface FindResult {
+    hits: FindHit[];
+}
+export interface SaveResult {
+    id: string;
+    kind: RecordKind;
+    created: boolean;
+    dryRun: boolean;
+    warnings: Diagnostic[];
+}
+export interface RemoveResult {
+    id: string;
+    kind: RecordKind;
+    deleted: boolean;
+    blockers: Diagnostic[];
+}
+export interface ValidationReport {
+    ok: boolean;
+    counts: Record<string, number>;
+    diagnostics: Diagnostic[];
+}
+export interface MetaResult {
+    dataDir: string;
+    version: string;
+    counts: Record<string, number>;
+    warnings: Diagnostic[];
+}
+export interface SaveOptions {
+    dryRun?: boolean;
+}
+export interface RemoveOptions {
+    dryRun?: boolean;
+}
+export interface ResolveRequest {
+    environmentId: string;
+    serviceId: string;
+    deploymentId?: string;
+}
+export interface RouteRequest {
+    operation: string;
+    environmentId: string;
+    serviceId?: string;
+    deploymentId?: string;
+}
+export interface SkillSummary {
+    name: string;
+    description?: string;
+    whenToUse?: string;
+    source?: string;
+    provider?: string;
+}
+export interface SkillSnapshot {
+    skills: SkillSummary[];
+    complete: boolean;
+}
+export interface SkillDirectory {
+    snapshot(options?: {
+        signal?: AbortSignal;
+    }): Promise<SkillSnapshot>;
+}
+export interface CredentialDirectory {
+    describe(ref: string): Promise<{
+        configured: boolean;
+        source?: string;
+    }>;
+    set(ref: string, value: string): Promise<void>;
+    unset(ref: string): Promise<void>;
+}
+export interface RegistrySnapshot {
+    environments: Map<string, Environment>;
+    services: Map<string, Service>;
+    deployments: Map<string, Deployment>;
+    ruleProfiles: Map<string, RuleProfile>;
+    operationBindings: Map<string, OperationBinding>;
+    byAlias: Map<string, string>;
+    diagnostics: Diagnostic[];
+    loadedAt: string;
+}

package/lib/domain/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/domain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/domain/types.ts"],"names":[],"mappings":""}

package/lib/index.d.ts

@@ -0,0 +1,18 @@
+import { Config } from './config.js';
+export declare const name = "dsh-env-manager";
+export declare const inject: string[];
+export { Config };
+export interface ApplyConfig {
+    dataDir?: string;
+    maxRecords?: number;
+    registerSkill?: boolean;
+    writePolicy?: {
+        allowUiProductionWrites?: boolean;
+        requireApprovalForDelete?: boolean;
+        requireApprovalForProductionSave?: boolean;
+    };
+    defaults?: {
+        environmentId?: string;
+    };
+}
+export declare function apply(ctx: any, config?: ApplyConfig): void;

package/lib/index.js

@@ -0,0 +1,89 @@
+import os from 'node:os';
+import { App } from './app/app.js';
+import { Config, normalizeConfig } from './config.js';
+import { consoleLogger } from './logger.js';
+import { resolveDataDir } from './storage/paths.js';
+import { cleanupTempFiles } from './storage/atomic.js';
+import { createEnvironmentManagerSkill } from './skill.js';
+import { createToolDefinitions } from './tools/tools.js';
+import { registerHttpTransport } from './transport/http.js';
+export const name = 'dsh-env-manager';
+export const inject = ['tools'];
+export { Config };
+export function apply(ctx, config = {}) {
+    const normalized = normalizeConfig(config);
+    const profileContext = ctx.get('profileContext');
+    const profileDir = profileContext?.dir ?? process.env.DSH_PROFILE_DIR ?? process.cwd();
+    const dataDir = resolveDataDir(normalized.dataDir, profileDir, process.cwd(), os.homedir());
+    const skills = ctx.get('skills');
+    const credentials = ctx.get('credentials');
+    const app = new App({
+        dataDir,
+        maxRecords: normalized.maxRecords,
+        writePolicy: {
+            allowUiProductionWrites: normalized.writePolicy.allowUiProductionWrites,
+        },
+        skills: skills
+            ? {
+                snapshot: (options) => skills.snapshot(options),
+            }
+            : null,
+        credentials: credentials
+            ? {
+                async describe(ref) {
+                    const info = await credentials.describe(ref);
+                    return { configured: info.configured, source: info.source };
+                },
+                async set(ref, value) {
+                    if (typeof credentials.set !== 'function') {
+                        throw new Error('the credential service is not writable');
+                    }
+                    await credentials.set(ref, value);
+                },
+                async unset(ref) {
+                    if (typeof credentials.unset !== 'function') {
+                        throw new Error('the credential service is not writable');
+                    }
+                    await credentials.unset(ref);
+                },
+            }
+            : null,
+        logger: consoleLogger,
+        defaults: normalized.defaults,
+    });
+    void app.init().catch((error) => {
+        consoleLogger.error(`Could not initialize ${dataDir}: ${error instanceof Error ? error.message : String(error)}`);
+    });
+    void cleanupTempFiles(dataDir).catch(() => undefined);
+    const disposeTools = [];
+    ctx.effect(() => {
+        const definitions = createToolDefinitions({
+            ctx,
+            app,
+            defaults: normalized.defaults,
+            writePolicy: normalized.writePolicy,
+        });
+        for (const definition of definitions) {
+            disposeTools.push(ctx.tools.register(definition));
+        }
+        const disposeHttp = registerHttpTransport(ctx, app, consoleLogger);
+        let disposeSkill;
+        if (normalized.registerSkill && skills && typeof skills.register === 'function') {
+            try {
+                disposeSkill = skills.register(createEnvironmentManagerSkill());
+                consoleLogger.debug('Registered discovery skill dsh-env-manager');
+            }
+            catch (error) {
+                consoleLogger.warn(`Could not register discovery skill: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return () => {
+            disposeSkill?.();
+            for (const dispose of disposeTools.splice(0))
+                dispose();
+            disposeHttp();
+        };
+    });
+    consoleLogger.info(`Environment registry ready at ${dataDir}`);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/logger.d.ts

@@ -0,0 +1,8 @@
+export interface Logger {
+    debug(message: string, details?: unknown): void;
+    info(message: string, details?: unknown): void;
+    warn(message: string, details?: unknown): void;
+    error(message: string, details?: unknown): void;
+}
+export declare const consoleLogger: Logger;
+export declare const silentLogger: Logger;

package/lib/logger.js

@@ -0,0 +1,13 @@
+export const consoleLogger = {
+    debug: (message, details) => console.debug(`[dsh-env-manager] ${message}`, details ?? ''),
+    info: (message, details) => console.info(`[dsh-env-manager] ${message}`, details ?? ''),
+    warn: (message, details) => console.warn(`[dsh-env-manager] ${message}`, details ?? ''),
+    error: (message, details) => console.error(`[dsh-env-manager] ${message}`, details ?? ''),
+};
+export const silentLogger = {
+    debug: () => undefined,
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+//# sourceMappingURL=logger.js.map

package/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC;IACzF,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC;IACvF,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC;IACvF,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC;CAC1F,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA"}

package/lib/memory/bridge.d.ts

@@ -0,0 +1,18 @@
+import type { OperationResolution } from '../domain/types.js';
+export interface OperationRecordDraft {
+    operation: string;
+    resolution: OperationResolution;
+    outcome: 'planned' | 'succeeded' | 'failed' | 'rejected';
+    evidence?: string[];
+}
+/**
+ * Optional memory integration. V1 never requires the memory plugin: the null
+ * bridge reports unavailability and never writes.
+ */
+export interface MemoryBridge {
+    readonly available: boolean;
+    emit(record: OperationRecordDraft): Promise<void>;
+    query(): Promise<never[]>;
+    propose(): Promise<never>;
+}
+export declare const nullMemoryBridge: MemoryBridge;

package/lib/memory/bridge.js

@@ -0,0 +1,13 @@
+export const nullMemoryBridge = {
+    available: false,
+    async emit() {
+        return undefined;
+    },
+    async query() {
+        return [];
+    },
+    async propose() {
+        throw new Error('Memory bridge is not configured');
+    },
+};
+//# sourceMappingURL=bridge.js.map

package/lib/memory/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/memory/bridge.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,SAAS,EAAE,KAAK;IAChB,KAAK,CAAC,IAAI;QACR,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,KAAK,CAAC,KAAK;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IACD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;CACF,CAAA"}

package/lib/registry/integrity.d.ts

@@ -0,0 +1,10 @@
+import type { Diagnostic, RecordKind, RegistrySnapshot } from '../domain/types.js';
+/** Referential checks over a loaded snapshot. Broken references are diagnostics. */
+export declare function checkIntegrity(snapshot: RegistrySnapshot): Diagnostic[];
+export interface Referrer {
+    kind: RecordKind;
+    id: string;
+    field: string;
+}
+/** Records that point at `kind/id`, used to block a delete. */
+export declare function findReferences(snapshot: RegistrySnapshot, kind: RecordKind, id: string): Referrer[];