dsh-mnemon-source-memory-spaces 0.5.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-external contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# dsh-mnemon-source-memory-spaces
+
+Memory Spaces owns its Provider contracts and private child-Fiber host. Provider authors depend on `dsh-mnemon-source-memory-spaces/provider-sdk`, never on the main repository's controllers or global registry.
+
+The Source owns its storage registry, scoped native command transport, recall policy, routing, receipts and management operations. It imports **no Provider implementation** and defines no extra Context service. Each mount defaults to a separate data directory; set `dataDir` explicitly to select an existing authority.
+
+Install the chosen Provider packages and configure them explicitly on the Source entry:
+
+```yaml
+name: dsh-mnemon-source-memory-spaces
+config:
+  dataDir: /absolute/path/to/memory
+  providers:
+    - use: dsh-mnemon-provider-holographic
+      instanceId: local-facts
+```
+
+The host must already provide `ctx.mnemonMemory`; a Strategy decides how this Source enters the LLM View. For programmatic composition, import `installMemorySpaces` and pass explicit typed child modules. It returns `Promise<void>`; no private Host or Snapshot escapes. Omitting the child list is an error, not automatic dependency discovery. The default `dsh-mnemon` bundle supplies the existing nine Providers and existing storage settings separately.
+
+Run `pnpm install && pnpm verify` in this directory. Its own tests mount real Cordis Fibers and exercise Source isolation, scoped management, View actions/routes, persistence and failed-child cleanup. Provider authors use `mountMemorySpaceProvider(module, { instanceId, config })` from the public `/testing` entry to test actual child registration and obtain frozen metadata plus `createAdapter`/`dispose`. `createMemorySpaceProviderFixture` supplies scoped authority and validated connection data for driver tests. Dispose the mounted fixture to release its adapters and Fiber. Neither fixture exposes the private Host, Registry or Snapshot; test the full Source separately for View integration.
+
+## Source-owned Client
+
+The optional ./client entry is a normal DSH Client module. This package owns
+its pages, browser API adapter, Host management operations, and tests. It only
+imports the public dsh-mnemon/client helpers; it never receives a Host Context,
+raw RPC transport, credentials, or an LLM View grant.
+
+The default distribution loads these same Client plugins through DSH. Each page
+uses Source-scoped read/mutate operations. Optional Agent-assisted cross-Source
+maintenance is advertised by the Host through the same scoped page client; it
+is not silently installed by a Source. There is one Slot owner per Source page,
+not a second fallback registration or copied default implementation.
+
+pnpm verify checks Host behavior and real Source-backed page interactions, then
+builds both Host and browser artifacts plus their public declarations. Client
+tests load the installed Core's browser artifact using dsh-mnemon/testing; they
+have no dependency on Core's repository sources or configuration files.