dsh-env-manager-plugin 0.1.0 → 0.1.1

package/docs/README.md

@@ -1,142 +1,142 @@
-# DSH Environment Manager Docs
-
-This directory is the **project-level Harness Context Hub** for the DSH Environment Manager plugin.
-
-It is used by humans and AI agents to understand project state, architecture, constraints, development standards, and operational procedures.
-
-## Reading Policy
-
-Do not read every document blindly. Read documents based on task type.
-
-### Required for Every Non-trivial Change
-
-1. `AGENTS.md` at the repository root
-2. `docs/00-project/project-brief.md`
-3. `docs/00-project/current-state.md`
-4. `docs/02-harness/harness-standard.md`
-5. `docs/04-development/development-guide.md`
-
-### Architecture or Schema Changes
-
-Also read:
-
-1. `docs/01-architecture/design.md`
-2. `docs/01-architecture/data-model.md`
-3. `docs/01-architecture/detailed-design.md`
-4. `docs/01-architecture/module-boundaries.md`
-5. `docs/01-architecture/storage-contract.md`
-
-### Environment Model Questions
-
-Also read:
-
-1. `docs/01-architecture/decisions/ADR-0010-environment-plane-model.md`
-2. `docs/01-architecture/decisions/ADR-0011-k8s-node-execution-model.md`
-3. `docs/01-architecture/data-model.md` §3
-4. `docs/01-architecture/ui-design.md` §6.3
-
-### Runtime API Questions
-
-Also read:
-
-1. `docs/01-architecture/api-verification.md`
-2. `docs/01-architecture/decisions/ADR-0009-client-host-http-transport.md`
-
-### Implementation Work
-
-Also read:
-
-1. `docs/01-architecture/implementation-plan.md`
-2. `docs/01-architecture/ui-design.md` (Client changes only)
-3. `docs/02-harness/client-ui-integration.md` (sidebar/main slot changes only)
-
-### Tool Surface Changes
-
-Also read:
-
-1. `docs/01-architecture/tool-contract.md`
-2. `docs/01-architecture/data-model.md`
-3. `docs/01-architecture/detailed-design.md` §11
-
-### Resolver / Rule Work
-
-Also read:
-
-1. `docs/01-architecture/design.md` §6
-2. `docs/05-domain/rule-template.md`
-3. `docs/01-architecture/decisions/ADR-0005-layered-rule-resolution.md`
-
-### Router / Skill Binding Work
-
-Also read:
-
-1. `docs/01-architecture/design.md` §7
-2. `docs/05-domain/operation-binding-template.md`
-3. `docs/01-architecture/decisions/ADR-0003-skill-router-over-search.md`
-
-### Security-Sensitive Work
-
-Also read:
-
-1. `docs/01-architecture/security-model.md`
-2. `docs/06-operations/security-policy.md`
-
-### Deployment / Operations Work
-
-Also read:
-
-1. `docs/06-operations/deployment-guide.md`
-2. `docs/06-operations/release.md`
-3. `docs/06-operations/security-policy.md`
-4. `docs/06-operations/troubleshooting.md`
-
-### OpenSpec Work
-
-Also read:
-
-1. `docs/03-openspec/proposal-rule.md`
-2. `docs/03-openspec/design-rule.md`
-3. `docs/03-openspec/spec-rule.md`
-4. `docs/03-openspec/tasks-rule.md`
-
-## Hard Rules
-
-- Durable registry data is YAML files under the plugin data directory.
-- Registry data is never committed to Git.
-- Credentials are references only; values never appear in registry files or tool output.
-- Rule templates use interpolation only; no code execution.
-- Production write operations and production-affecting management writes require approval.
-- Conflicts, missing Skills and broken references fail loudly; nothing is chosen silently.
-- Every completed change updates `docs/00-project/current-state.md`.
-
-## Directory Map
-
-```text
-docs/
-├── 00-project/       # brief, current state, glossary, roadmap
-├── 01-architecture/  # design, data model, tools, storage, security, ADRs
-├── 02-harness/       # AI-assisted development harness standards
-├── 03-openspec/      # proposal/design/spec/tasks rules
-├── 04-development/   # coding, testing, local run, dependency rules
-├── 05-domain/        # environment/service/deployment/rule/binding templates
-├── 06-operations/    # deployment, release, security, troubleshooting
-├── 07-templates/     # reusable artifact templates
-└── 99-archive/       # obsolete or historical docs
-```
-
-### Architecture Index
-
-| Document | Purpose |
-|---|---|
-| `architecture-overview.md` | layers, components, request flows |
-| `design.md` | V1 scope, algorithms, acceptance criteria |
-| `detailed-design.md` | module contracts, algorithms, tool/HTTP specs, tests |
-| `data-model.md` | record schemas and result types |
-| `tool-contract.md` | model-facing tool inputs, outputs, errors |
-| `storage-contract.md` | files, atomicity, sessions, migration |
-| `module-boundaries.md` | module ownership and dependencies |
-| `ui-design.md` | panels, transport, states, i18n, QA checklist |
-| `security-model.md` | credential, policy and redaction controls |
-| `api-verification.md` | verified DSH runtime facts and open probes |
-| `implementation-plan.md` | ordered tasks, acceptance, cut line |
-| `decisions/ADR-*.md` | accepted decisions (ADR-0009 = UI transport, ADR-0010 = environment/plane model, ADR-0011 = K8s node/access model) |
+# DSH Environment Manager Docs
+
+This directory is the **project-level Harness Context Hub** for the DSH Environment Manager plugin.
+
+It is used by humans and AI agents to understand project state, architecture, constraints, development standards, and operational procedures.
+
+## Reading Policy
+
+Do not read every document blindly. Read documents based on task type.
+
+### Required for Every Non-trivial Change
+
+1. `AGENTS.md` at the repository root
+2. `docs/00-project/project-brief.md`
+3. `docs/00-project/current-state.md`
+4. `docs/02-harness/harness-standard.md`
+5. `docs/04-development/development-guide.md`
+
+### Architecture or Schema Changes
+
+Also read:
+
+1. `docs/01-architecture/design.md`
+2. `docs/01-architecture/data-model.md`
+3. `docs/01-architecture/detailed-design.md`
+4. `docs/01-architecture/module-boundaries.md`
+5. `docs/01-architecture/storage-contract.md`
+
+### Environment Model Questions
+
+Also read:
+
+1. `docs/01-architecture/decisions/ADR-0010-environment-plane-model.md`
+2. `docs/01-architecture/decisions/ADR-0011-k8s-node-execution-model.md`
+3. `docs/01-architecture/data-model.md` §3
+4. `docs/01-architecture/ui-design.md` §6.3
+
+### Runtime API Questions
+
+Also read:
+
+1. `docs/01-architecture/api-verification.md`
+2. `docs/01-architecture/decisions/ADR-0009-client-host-http-transport.md`
+
+### Implementation Work
+
+Also read:
+
+1. `docs/01-architecture/implementation-plan.md`
+2. `docs/01-architecture/ui-design.md` (Client changes only)
+3. `docs/02-harness/client-ui-integration.md` (sidebar/main slot changes only)
+
+### Tool Surface Changes
+
+Also read:
+
+1. `docs/01-architecture/tool-contract.md`
+2. `docs/01-architecture/data-model.md`
+3. `docs/01-architecture/detailed-design.md` §11
+
+### Resolver / Rule Work
+
+Also read:
+
+1. `docs/01-architecture/design.md` §6
+2. `docs/05-domain/rule-template.md`
+3. `docs/01-architecture/decisions/ADR-0005-layered-rule-resolution.md`
+
+### Router / Skill Binding Work
+
+Also read:
+
+1. `docs/01-architecture/design.md` §7
+2. `docs/05-domain/operation-binding-template.md`
+3. `docs/01-architecture/decisions/ADR-0003-skill-router-over-search.md`
+
+### Security-Sensitive Work
+
+Also read:
+
+1. `docs/01-architecture/security-model.md`
+2. `docs/06-operations/security-policy.md`
+
+### Deployment / Operations Work
+
+Also read:
+
+1. `docs/06-operations/deployment-guide.md`
+2. `docs/06-operations/release.md`
+3. `docs/06-operations/security-policy.md`
+4. `docs/06-operations/troubleshooting.md`
+
+### OpenSpec Work
+
+Also read:
+
+1. `docs/03-openspec/proposal-rule.md`
+2. `docs/03-openspec/design-rule.md`
+3. `docs/03-openspec/spec-rule.md`
+4. `docs/03-openspec/tasks-rule.md`
+
+## Hard Rules
+
+- Durable registry data is YAML files under the plugin data directory.
+- Registry data is never committed to Git.
+- Credentials are references only; values never appear in registry files or tool output.
+- Rule templates use interpolation only; no code execution.
+- Production write operations and production-affecting management writes require approval.
+- Conflicts, missing Skills and broken references fail loudly; nothing is chosen silently.
+- Every completed change updates `docs/00-project/current-state.md`.
+
+## Directory Map
+
+```text
+docs/
+├── 00-project/       # brief, current state, glossary, roadmap
+├── 01-architecture/  # design, data model, tools, storage, security, ADRs
+├── 02-harness/       # AI-assisted development harness standards
+├── 03-openspec/      # proposal/design/spec/tasks rules
+├── 04-development/   # coding, testing, local run, dependency rules
+├── 05-domain/        # environment/service/deployment/rule/binding templates
+├── 06-operations/    # deployment, release, security, troubleshooting
+├── 07-templates/     # reusable artifact templates
+└── 99-archive/       # obsolete or historical docs
+```
+
+### Architecture Index
+
+| Document | Purpose |
+|---|---|
+| `architecture-overview.md` | layers, components, request flows |
+| `design.md` | V1 scope, algorithms, acceptance criteria |
+| `detailed-design.md` | module contracts, algorithms, tool/HTTP specs, tests |
+| `data-model.md` | record schemas and result types |
+| `tool-contract.md` | model-facing tool inputs, outputs, errors |
+| `storage-contract.md` | files, atomicity, sessions, migration |
+| `module-boundaries.md` | module ownership and dependencies |
+| `ui-design.md` | panels, transport, states, i18n, QA checklist |
+| `security-model.md` | credential, policy and redaction controls |
+| `api-verification.md` | verified DSH runtime facts and open probes |
+| `implementation-plan.md` | ordered tasks, acceptance, cut line |
+| `decisions/ADR-*.md` | accepted decisions (ADR-0009 = UI transport, ADR-0010 = environment/plane model, ADR-0011 = K8s node/access model) |

package/icon.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
-  <circle cx="32" cy="32" r="28" fill="#0ea5e9"/>
-  <path d="M22 20h20v8H22zm0 14h20v8H22z" fill="#ffffff"/>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <circle cx="32" cy="32" r="28" fill="#0ea5e9"/>
+  <path d="M22 20h20v8H22zm0 14h20v8H22z" fill="#ffffff"/>
+</svg>

package/index.js

@@ -1,8 +1,31 @@
-/**
- * DSH Environment Manager - Host entry point.
- *
- * The implementation lives in `lib/` (compiled from `src/`); this shim keeps the
- * bundle entry stable across builds.
- */
-
-export { name, inject, Config, apply } from './lib/index.js'
+/**
+ * DSH Environment Manager - Host entry point.
+ *
+ * The implementation lives in `lib/` (compiled from `src/`); this shim keeps the
+ * bundle entry stable across builds. `lib/` is committed so a checkout, git
+ * install or npm tarball all have the same executable entry.
+ */
+
+let implementation
+
+try {
+  implementation = await import('./lib/index.js')
+} catch (error) {
+  const missingLib =
+    error &&
+    error.code === 'ERR_MODULE_NOT_FOUND' &&
+    /lib[\\/]index\.js/.test(String(error.message))
+
+  if (missingLib) {
+    throw new Error(
+      '[dsh-env-manager-plugin] Missing build output: lib/index.js. ' +
+        'Install the published `dsh-env-manager-plugin` package, or run ' +
+        '`npm install && npm run build` in the plugin checkout before installing it.',
+      { cause: error },
+    )
+  }
+
+  throw error
+}
+
+export const { name, inject, Config, apply } = implementation

package/lib/skill.js

@@ -1,43 +1,43 @@
 export const ENV_MANAGER_SKILL_NAME = 'dsh-env-manager';
 export const ENV_MANAGER_SKILL_DESCRIPTION = 'Use when the user mentions DSH Environment Manager, a registered environment, host, service, deployment, log collection, restart or deploy, or asks where a registered service runs.';
 export const ENV_MANAGER_SKILL_WHEN_TO_USE = 'The user asks which environment to use, where a registered service or host runs, how to find its paths or logs, or wants an operation on a registered environment.';
-export const ENV_MANAGER_SKILL_CONTENT = `# DSH Environment Manager
-
-Use the environment registry as the source of truth for registered environments, hosts,
-services, deployments and operation routes. This is not the operating-system or Python
-"environment"; it is the DSH Environment Manager registry.
-
-## Workflow
-
-1. Discover before guessing.
-   - Use \`env_list\` for an inventory.
-   - Use \`env_find\` with an id, name, alias or category fragment.
-   - If more than one candidate matches, ask which one the user means; do not pick one.
-
-2. Pin the session when the user commits to one environment.
-   - Call \`env_set_context\` with the environment id.
-   - Use \`env_get_context\` to confirm it.
-   - Once pinned, later calls may omit \`environmentId\`.
-
-3. Resolve concrete context.
-   - Use \`env_get\` when the raw record or YAML is needed.
-   - Use \`env_resolve\` for the service context, paths, logs, variables and provenance.
-   - Prefer the resolver over reconstructing paths from templates.
-
-4. Route an operation before acting.
-   - Before deploy, redeploy, restart, rollback, collect-logs or a similar action, call
-     \`env_resolve_operation\` with the environment and service or deployment.
-   - A missing, ambiguous or conflicting binding is an error; do not invent a skill or
-     fall back to a different environment.
-   - \`env_resolve_operation\` returns a route; it does not execute the skill.
-
-## Boundaries
-
-- Do not assume the current workspace's files are the registry.
-- Do not print credential values; report only whether a credential is configured.
-- Respect approval and policy results; never bypass them because a route looks obvious.
-- If the user says "not this environment", clear or replace the session default with
-  \`env_set_context\`; do not silently keep the old one.
+export const ENV_MANAGER_SKILL_CONTENT = `# DSH Environment Manager
+
+Use the environment registry as the source of truth for registered environments, hosts,
+services, deployments and operation routes. This is not the operating-system or Python
+"environment"; it is the DSH Environment Manager registry.
+
+## Workflow
+
+1. Discover before guessing.
+   - Use \`env_list\` for an inventory.
+   - Use \`env_find\` with an id, name, alias or category fragment.
+   - If more than one candidate matches, ask which one the user means; do not pick one.
+
+2. Pin the session when the user commits to one environment.
+   - Call \`env_set_context\` with the environment id.
+   - Use \`env_get_context\` to confirm it.
+   - Once pinned, later calls may omit \`environmentId\`.
+
+3. Resolve concrete context.
+   - Use \`env_get\` when the raw record or YAML is needed.
+   - Use \`env_resolve\` for the service context, paths, logs, variables and provenance.
+   - Prefer the resolver over reconstructing paths from templates.
+
+4. Route an operation before acting.
+   - Before deploy, redeploy, restart, rollback, collect-logs or a similar action, call
+     \`env_resolve_operation\` with the environment and service or deployment.
+   - A missing, ambiguous or conflicting binding is an error; do not invent a skill or
+     fall back to a different environment.
+   - \`env_resolve_operation\` returns a route; it does not execute the skill.
+
+## Boundaries
+
+- Do not assume the current workspace's files are the registry.
+- Do not print credential values; report only whether a credential is configured.
+- Respect approval and policy results; never bypass them because a route looks obvious.
+- If the user says "not this environment", clear or replace the session default with
+  \`env_set_context\`; do not silently keep the old one.
 `;
 export function createEnvironmentManagerSkill() {
     return {

package/locale/en.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "DSH Environment Manager",
-    "description": "Manages enterprise environments, services, deployments and operation-skill bindings for DSH sessions."
-  }
-}
+{
+  "meta": {
+    "title": "DSH Environment Manager",
+    "description": "Manages enterprise environments, services, deployments and operation-skill bindings for DSH sessions."
+  }
+}

package/locale/zh.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "DSH 环境管理器",
-    "description": "为 DSH 会话管理企业环境、服务、部署实例以及操作与 Skill 的绑定关系。"
-  }
-}
+{
+  "meta": {
+    "title": "DSH 环境管理器",
+    "description": "为 DSH 会话管理企业环境、服务、部署实例以及操作与 Skill 的绑定关系。"
+  }
+}

package/package.json

@@ -1,99 +1,101 @@
-{
-  "name": "dsh-env-manager-plugin",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Environment registry, service catalog and operation-to-Skill routing for DSH.",
-  "author": "zhiwuli0228",
-  "homepage": "https://github.com/zhiwuli0228/dsh-env-manager#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zhiwuli0228/dsh-env-manager.git"
-  },
-  "bugs": {
-    "url": "https://github.com/zhiwuli0228/dsh-env-manager/issues"
-  },
-  "exports": {
-    ".": "./index.js",
-    "./client": "./client.js",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "index.js",
-    "client.js",
-    "cordis.patch.yml",
-    "lib/",
-    "locale/*.json",
-    "icon.svg",
-    "README.md",
-    "LICENSE",
-    "docs/"
-  ],
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "environment",
-    "service-registry",
-    "ops"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=20",
-    "dsh": ">=0.2.1-rc.5"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "immediately": true
-    }
-  },
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.5",
-    "yaml": "^2.9.1",
-    "zod": "^4.6.7"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-sandbox": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-scope": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-user-approval": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-util-values": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.5",
-    "@types/node": "^24.19.2",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.7"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "check": "npm run typecheck && npm run build && npm test && node --check client.js",
-    "prepack": "npm run build"
-  },
-  "main": "index.js",
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.5"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": "true"
-    }
-  }
-}
+{
+  "name": "dsh-env-manager-plugin",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Environment registry, service catalog and operation-to-Skill routing for DSH.",
+  "author": "zhiwuli0228",
+  "homepage": "https://github.com/zhiwuli0228/dsh-env-manager#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhiwuli0228/dsh-env-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zhiwuli0228/dsh-env-manager/issues"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "lib/",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "LICENSE",
+    "docs/",
+    "scripts/repair-profile.mjs"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "environment",
+    "service-registry",
+    "ops"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.2.1-rc.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-scope": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-user-approval": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-util-values": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.5",
+    "@types/node": "^24.19.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "npm run typecheck && npm run build && npm test && node --check client.js && node --check index.js",
+    "repair:profile": "node scripts/repair-profile.mjs",
+    "prepack": "npm run build"
+  },
+  "main": "index.js",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.5"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": "true"
+    }
+  }
+}