@lmzhen/dsh-evolution-skill-discovery 0.32.4 → 0.32.6

package/README.md

@@ -1,17 +1,29 @@
 # @lmzhen/dsh-evolution-skill-discovery
 
-Read model and view identity for evolution skill discovery (Program B, PLAN-DISC-001).
+Optional skill search, domain projection, and catalog-trimming package. The main entry is `main-entry.ts`, not the package root helper modules.
 
-## Status
+## Default and independent search
 
-The package has a real `apply`, is referenced by the `evolution-all` bundle row, and is booted from a test `cordis.yml` through the Loader. The model-facing surface is `skill_search` plus injected, read-only domain cards. DomainMap bootstrap, explicit generation, and projection are implemented. Create-time assignment/classification and shadow mode are not shipped; provisional domains are not auto-promoted. The command surface is `/skill-domain status | generate`. The map plane is explicit experimental: default `mode:off`, no catalog rewrite or hidden skills.
+`mode` defaults to `off`. Domain cards, domain-map projection, and catalog trimming do not run in this mode.
 
-## Contract
+`skill_search` is independently registered unless `searchEnabled:false`. It searches name, description, and `whenToUse` summaries, not skill bodies. Results default to 3 and are capped at 20. Empty or degraded results include a hint to use the full catalog or load an exact skill by name.
 
-- `SkillIndex` reads a source's `ctx.skills`-shaped snapshot and a managed-skill key set; it does not register a provider or cache a second catalog.
-- `viewKey/viewCatalogDigest/catalogRevision/policyDigest/projectionDigest/searchIndexKey` are deterministic SHA-256 identities.
-- Incomplete snapshots keep `complete:false`; callers must fail open, not hide skills.
+`featureEpoch` is required even when discovery is off. The composition also requires the declared platform services, including `skills`, `workingDirectory`, `tools`, `evolutionIo`, and `systemPrompt`.
 
-## Verification
+## Enabling domain mode
 
-`pnpm exec vitest run packages/evolution/evolution-skill-discovery/tests/discovery.spec.ts --maxWorkers=1`
+`mode:on` requires an LLM service. Generation defaults to provider `deepseek-official` and model `deepseek-flash`; `generationTimeoutMs`, `generationMaxTokens`, and `generationAttempts` tune that port.
+
+Domain state defaults to these files below the evolution home:
+
+- `evolution/domain-map.json` (`domainMapPath`)
+- `evolution/projection-journal.json` (`projectionJournalPath`)
+- `evolution/view-snapshots.json` (`viewSnapshotPath`)
+
+`maxCards`, `tokenBudget`, `staleAfterHours`, and `descriptionStaleAfterHours` control projection and refresh budgets. Description refresh defaults to 168 hours. `pinDomains`, `disableDomains`, `workspacePolicy`, `scopePolicy`, and their path-based layers control the effective domain policy.
+
+## Commands and failure boundaries
+
+With domain mode on, `/skill-domain status` inspects the current view and `/skill-domain generate` builds a domain map. Generation also requires `mapReferenceCwd`; the command refuses to infer a global map from the caller view. `mapReferenceScope` optionally overrides the reference scope.
+
+Projection failures fail open to the original decision so discovery does not hide the ordinary catalog. Search/index degradation is reported explicitly rather than returned as a silent empty result.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-skill-discovery",
   "description": "Read model and view identity for evolution skill discovery (community build)",
-  "version": "0.32.4",
+  "version": "0.32.6",
   "publishConfig": {
     "access": "public"
   },
@@ -32,8 +32,8 @@
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.32.4",
-    "@lmzhen/dsh-evolution-io": "^0.32.4"
+    "@lmzhen/dsh-evolution-core": "^0.32.6",
+    "@lmzhen/dsh-evolution-io": "^0.32.6"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-skill": "^0.2.1-rc.2",
@@ -43,8 +43,8 @@
     "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.32.4",
-    "@lmzhen/dsh-evolution-io": "^0.32.4"
+    "@lmzhen/dsh-evolution-core": "^0.32.6",
+    "@lmzhen/dsh-evolution-io": "^0.32.6"
   },
   "dependencies": {
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",