@yugoo-design/dsh-design-system-dsh 0.0.0-stage → 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,18 @@
+Yugoo-design
+Copyright 2026 YugooDesign Team
+
+Yugoo Design was initiated by Jianfeng Yang, who independently completed
+its initial design and development. The project is maintained by
+YugooDesign Team.
+
+Except where otherwise identified, the original code and documentation in this
+repository are licensed under the Apache License, Version 2.0. See LICENSE.
+
+Third-party code, dependencies, vendored runtimes, and attributed materials
+retain their own licenses and copyright notices. This notice does not relicense
+those materials. See THIRD_PARTY_NOTICES.md and applicable component notices.
+
+DSH distribution materials for this package: licenses/dsh-distribution.json.
+It lists actual output hashes, selected original texts in this package, and external npm dependencies separately.
+Existing third-party materials retain their individual terms.
+Historical Companion/source observations are not claims of complete coverage for this DSH archive.

package/README.md

@@ -1,3 +1,362 @@
-# Temporary Holding Version
+# Yugoo Design for DeepSeek Harness
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+New Design Projects default to the system user's Documents directory under
+`YuGoo/Projects`, using the same Core registry as Companion. Windows Documents
+redirection and Linux XDG user directories are honored; WSL uses Linux storage.
+An explicit Core `projectsRoot` still wins. Existing projects, registry, native
+conversation bindings and runtime state stay at their original paths; this
+changes new-project placement, not DSH authentication or host integration.
+
+The single external DeepSeek Harness installation bundle for Yugoo Design. Official DSH is a read-only Host compatibility target: this package uses public Cordis, command, tool, Agent, interaction, subagent, Remote, and client-module extension points and requires no DSH patch, fork, or Design-specific release. Installing it adds direct Loader rows for generic Core, Panel, Studio, Design Knowledge, the official Web App provider, and the official Web App content Kit. DeepSeek Harness discovers each package's browser plugin through its own `dsh.client` declaration; this distribution does not compile or hide a combined client. The Settings launcher opens the full-page `/design-studio/` workspace, which uses the same Typert Remote and storage-domain-backed Studio service without creating a Session or Agent.
+
+`dsh-design-skills-web-app` contains one Mindset plus self-contained Bundle
+files, including optional ordinary Agent-facing scripts. Generic Core confines
+their execution and gives them no Design Files or Git authority.
+The official Web App Kit's 14 Bundles now declare their presentations in
+`panel.yaml`, using shared components supplied by `dsh-design-panel`.
+`dsh-design-provider-web-app` remains in this distribution for explicitly selected
+native presentations and comparison; it is not the default presentation contract
+of those declarative Bundles. Neither presentation layer owns generation,
+validation, repair, or publication logic. Generic Core, Panel, and Studio do not
+depend on the Web App Kit or its native provider. A Kit can revise its validated
+panel definition or locale content without rebuilding the Host; introducing a
+new shared runtime component or native UI surface requires a runtime release.
+Installed-package native-equivalence acceptance remains separate from this
+source declaration and is not established by the presence of 14 definitions.
+
+## Daily entry and compatibility
+
+Use `/yugoo` in the existing DSH conversation to open the project command help,
+or `/yugoo new <name>`, `/yugoo open <id|name|path>` and `/yugoo status` to manage
+Design Projects. These commands share the existing project service and native
+conversation binding; they do not start a second host or change authentication.
+
+`/design` remains a compatibility alias to the same handler when that name is
+available. If another plugin already owns `/design`, Yugoo Design leaves it
+untouched and warns that the alias is unavailable. A conflict on the primary
+`/yugoo` entry fails registration explicitly. Panel actions use `/yugoo` so they
+cannot accidentally invoke a different plugin's `/design` command.
+
+## Installation target and current package composition
+
+The product name is **yugoo-design**. Source package and Loader identifiers remain
+`dsh-design-*`; public npm exports use the `@yugoo-design` scope. The brand does
+not rename imports or Loader identities.
+Official DSH is an external, separately installed host and is not one of the
+plugin's system packages. Its agents supply model execution, questions,
+subagents and search; installing this plugin must preserve the user's existing
+model/search configuration and must not ask for a plugin-specific search key.
+
+The current official DSH distribution comprises these ten system packages.
+The directory column identifies the existing source package, not an end-user
+checkout or build requirement.
+
+| Package identifier | Source directory | Role |
+| --- | --- | --- |
+| `dsh-design-system-dsh` | `packages/dsh` | DSH installation bundle and Loader registration |
+| `dsh-design-core` | `packages/core` | Design state, Bundle execution and validation |
+| `dsh-design-panel` | `packages/panel` | Shared Panel runtime and components |
+| `dsh-design-knowledge-ladybug` | `packages/knowledge-ladybug` | Design Knowledge provider |
+| `dsh-design-provider-web-app` | `packages/provider-web-app` | Retained, explicitly selected native Web App presentations |
+| `dsh-design-skills-web-app` | `packages/skills-web-app` | Official Web App Kit content |
+| `dsh-design-skills-decision-modeling` | `packages/skills-decision-modeling` | Decision Modeling Kit content |
+| `dsh-design-studio` | `packages/studio` | Host-neutral Studio service |
+| `dsh-design-studio-ui` | `packages/studio-ui` | Shared Studio interface |
+| `dsh-design-studio-dsh` | `packages/studio-dsh` | DSH Studio integration |
+
+The Knowledge provider selects the official `@ladybugdb/wasm-core` at exact
+version **`0.21.1`**. This is a third-party runtime dependency, not an eleventh
+system package or a replacement DSH application. Do not substitute the earlier
+WAL fork, an unpublished fixture alias, or `latest`.
+
+### Agent-led installation and local release files
+
+After publication, copy the [DSH-specific installation prompt](../companion/HOSTS.md#install-or-update-deepseek-harness)
+into the existing host conversation. The Agent acquires the exact product installer
+from npm and uses its `release-hosts.json` to install the aggregate and internal
+modules through the official host. Users do not acquire all ten modules manually.
+Use the accepted public installation guide and exact release manifest; the host Agent should:
+
+1. Identify the installed official DSH version and check the selected release's
+   required host peers, including Core's Cordis minimum `^4.0.2`.
+2. Resolve the exact ten-package release and Ladybug `0.21.1`, then install the
+   DSH bundle through the official host's package/bundle interface. Preserve
+   existing user profiles, models and search settings.
+3. Confirm the Loader registrations and open a Design Project with its pinned
+   Kit. Run a nonempty Bundle, edit and save its Panel, reopen it, and confirm
+   the canonical data and checkpoint. Verify KAG and GRA through actual host
+   execution, reporting any capability or credential limitation explicitly.
+
+The npm scope is `@yugoo-design` and the first beta target is `0.1.0-beta.1`,
+with dist-tag `beta`; `latest` stays unchanged. Companion and all ten owned DSH
+packages use that same exact npm version. Native suite and Kit/Bundle content
+versions do not change with the npm prerelease. The packages are being prepared
+and are not yet published; the registry-based route still needs acceptance.
+The supplied local files below are for pre-publication preflight, rather than
+the main public installation tutorial. A package-manager exit code, Loader mount or
+MCP listing alone does not prove that Bundle generation, Panel saving, GRA and
+KAG work. The developer launcher and clone/build steps are not the user install
+path; Companion hosts use their own adapters rather than this DSH bundle.
+
+### Current Windows host admission
+
+Official Windows DSH **`0.2.0-rc.2`** is the current release target. The affected
+host peer declarations append that exact prerelease to their existing supported
+ranges; they do not admit unknown RCs, `0.2.0` stable, or React 19. The earlier
+`0.1.2-rc.1` development pins and historical local results below stay unchanged.
+Loader compatibility uses its own prerelease policy and is not a substitute for
+the package manager's strict peer resolution.
+
+On the current host, advisory settings use the owning plugin's live `Config`
+fields and the public `SettingsForms` projection. The host owns profile entry
+identity, persistence and change delivery; the plugin creates no second settings
+store. The Studio launcher consumes Slots and Locale only, retaining its
+`settings.section` registration without requiring the removed, unused
+`settingsScope` service. Pending question cancellation reads the current
+session-status projection while preserving the exact session and question id.
+Only an actual cancellation channel is invoked: the current host's hide-only
+tool-call card dismissal is not reported as cancellation.
+Existing section-provider and legacy-host adapters remain supported; unknown
+interfaces fail explicitly rather than being replaced by empty or fake services.
+
+Public API checks and isolated lifecycle fixtures establish only their tested
+boundaries. The fixed beta archives still require actual strict installation,
+native activation, browser interaction and functional regression as separate
+acceptance steps; this declaration does not claim those outcomes.
+
+### Unpublished release: official local workspace route
+
+This route verifies a received fixed local candidate before registry publication.
+Its historical installation results remain tied to those archives; they do not
+establish beta registry acquisition, update or native-host acceptance.
+
+The local delivery includes ten compiled `.tgz` packages, `PORTABLE-INPUTS.json`
+(archive filenames, package identities and SHA-256), `PORTABLE-PROVIDERS.json`
+(exact public dependency versions), `portable-install.mjs`, and
+`PORTABLE-RECIPE.md`. Keep these files together. No source checkout, source build,
+host patch, package-manifest rewrite or developer dependency tree is required.
+This is the local-file route for the same product, not an additional Companion
+installation inside DSH.
+
+The checked host is official DSH **0.1.2-rc.1**. Its actual `plugin` command
+forwards **pnpm 9.15.4**; verify that command rather than a separately installed
+pnpm executable. React and ReactDOM remain **18.3.1**.
+
+Have your host agent perform these steps using recipient-owned absolute paths:
+
+1. Initialize a new `yugoo-local` profile through the official DSH CLI with an
+   explicitly owned `DSH_HOME`, separate from your existing home and profiles:
+
+   ```sh
+   DSH_HOME=/recipient/owned-dsh-home node /recipient/official-dsh/lib/bin.js \
+     plugin --profile yugoo-local --version
+   ```
+
+   This normal first use initializes the profile and probes the forwarded pnpm
+   version; there is no separate `init` subcommand in this recipe. Preserve your
+   existing model, search and credential configuration.
+2. Verify every archive against `PORTABLE-INPUTS.json`. Safely extract its
+   compiled `package/` contents into the profile's `packages/<package-name>`
+   directory, using the unscoped name (for example,
+   `profiles/yugoo-local/packages/dsh-design-core`). Reject absolute/traversing
+   paths, links and special archive members;
+   verify the unchanged extracted package name and version. Do not rewrite them.
+3. Retain the profile workspace root (`.`), add `packages/*`, and preserve the
+   official `nodeLinker: hoisted` and `autoInstallPeers: false` defaults. Use a
+   separate empty npm userconfig for this isolated installation.
+4. Run the supplied helper without `--execute` to validate inputs and print the
+   exact official command. It compares every original regular archive member
+   against staged bytes and executable modes, rejecting missing or changed
+   files, unsafe archive paths and symlinked staged paths/profile directories.
+   Matching package names and versions alone are insufficient. Replace all
+   example paths with your own:
+
+   ```sh
+   node portable-install.mjs \
+     --dsh-bin /recipient/official-dsh/lib/bin.js \
+     --dsh-home /recipient/owned-dsh-home \
+     --archives-dir /recipient/release-files \
+     --npm-userconfig /recipient/empty.npmrc
+   ```
+
+5. Review the printed command, then explicitly add `--execute` to install. It
+   uses the ten original workspace packages and exact public providers through
+   the official CLI, with strict peer checking and explicit hoisted/no-auto-peer
+   settings. The helper does not initialize profiles, extract packages, start
+   DSH or configure models. Do not add `--no-frozen-lockfile` to `pnpm add`.
+6. Check ten Loader identities, the aggregate registration, exact root providers,
+   Core-local host dependencies, all declared peer ranges and all runtime entry
+   resolutions. Then start the official host and perform the project/Kit and
+   save/reopen checks described above; dependency installation alone is not
+   functional acceptance.
+
+The actual isolated official installation completed with strict checking:
+ten Loader identities, eleven runtime entries and 52 declared peer checks passed.
+The corrected helper's final ten-archive dry-run verified 1,198 original members;
+eleven negative controls, including real older staging paired with final
+archives, were rejected. Its `--execute` path subsequently installed those final
+ten archives successfully; post-install checks retained all 1,198 original
+members and matched 57 pinned providers. These results establish installation/load composition only,
+not Cordis activation, all Panel interactions or another-machine acceptance.
+Keep installation receipts and the owned profile for inspection and recovery;
+no automatic rollback is promised.
+
+### Host activation and content watching
+
+For the checked official DSH 0.1.2-rc.1 composition, select the profile's public
+`patchReload: startup` mode. Include the official `@deepseek-ai/dsh-web-app`
+0.1.2-rc.1 carrier when opening Studio; its `webServer` service is required by
+the Studio page. Keep the server on loopback and use the host's normal
+authentication. An unauthenticated HTTP 401 confirms neither a usable page nor
+Panel acceptance.
+
+Install the official base and Web App carrier into that same owned profile,
+after the local design packages and their pinned peers have been installed:
+
+```sh
+DSH_HOME=/recipient/owned-dsh-home node /recipient/official-dsh/lib/bin.js \
+  plugin --profile yugoo-local add --workspace-root --save-exact \
+  @deepseek-ai/dsh-base@0.1.2-rc.1 @deepseek-ai/dsh-web-app@0.1.2-rc.1 \
+  --strict-peer-dependencies --config.node-linker=hoisted \
+  --config.auto-install-peers=false --registry=https://registry.npmjs.org
+```
+
+Do not mix profile-local Agent plugins with fallback base modules from a different
+installation. Matching version strings alone are insufficient: Agent loop,
+presets and session controller must resolve the same physical `dsh-scope` module.
+Separate module instances have different scope symbols and can reject session
+creation before any model request. The checked normal profile installation
+resolved all three consumers to one module; it did not patch the official host.
+
+The setting lives in the owned profile's `package.json` at
+`dsh.profile.patchReload`, not in a separate `profile.json`. Preserve the existing
+bundle list when setting it. The official launcher accepts repeatable `--patch`
+overlays; a recipient command has this form:
+
+```sh
+DSH_HOME=/recipient/owned-dsh-home node --expose-internals \
+  /recipient/official-dsh/lib/bin.js --profile yugoo-local \
+  --patch /recipient/official-dsh-web-app/cordis.patch.yml \
+  --patch /recipient/owned-runtime.patch.yml \
+  --host 127.0.0.1 --port 0 --no-open
+```
+
+Use your installed carrier's actual path and an owned runtime overlay for Core
+project/state roots and any explicit Kit watcher settings. Do not copy test
+directories or overwrite existing model/search settings. The verification below
+called the launcher's installed `runProfile` implementation; it did not execute
+this example as a separate CLI process.
+
+This mode requires restarting DSH after changing host Cordis patch configuration.
+It does not disable the Design Kit content watcher. To watch a package-backed
+Kit, explicitly set `watch: true` on its existing Kit Loader configuration,
+retaining its `packageName` and discovery settings. The checked installed
+`runProfile` implementation started successfully, exposed both bundled Kits and
+read an existing Design Project. With that watcher enabled, an isolated same-version
+Web App mindset edit became visible through the actual Kit catalog; the original
+content was restored and the project's thirteen Design Files remained unchanged.
+These checks used the earlier validated installation, not a replay of every
+final release archive, and did not create an Agent or invoke a model.
+
+Do not select `patchReload: live` as a workaround: the checked official
+composition calls `hmr.registerConfig`, which its installed HMR 1.0.19 does not
+provide. This host patch-reload limitation remains unresolved; no host patch,
+fake HMR service or automatic dependency upgrade is part of this delivery.
+Successful startup/content watching does not establish authenticated UI,
+generation, save/reopen, KAG or GRA acceptance.
+
+For content authors, see the existing [Creator and Panel declaration guide](../../docs/wiki/extending.md#panel-选择).
+Reuse the actual generic component catalog and preserve schema bindings, stable
+IDs and locale resources. Validated Kit content reload/version updates apply
+Panel and locale declaration changes without recompiling the runtime; source
+edits do not automatically update installed packages or switch project pins.
+New runtime components or executable Provider changes require their own build
+and release.
+
+### Candidate npm installer: DSH route and recovery limits
+
+The generated Companion npm candidate also exposes an `install --host dsh`
+route. This is an installer adapter for the separately installed official DSH
+host, not a bundled DSH application or a desktop Companion runtime inside DSH.
+Yugoo design has one product installation entry. For DSH, that entry installs
+the exact mapped aggregate and its internal modules automatically; users do
+not install the internal packages individually. DSH itself remains an external
+host. The Companion payload is not registered as a DSH bundle.
+
+This route requires an existing isolated or user-selected DSH profile, an
+absolute `--dsh-config` JSON file pinning the official Node/CLI/Loader inputs,
+`--profile`, and an external `--receipt-dir`. A bound product
+`release-hosts.json` supplies the exact aggregate version and HTTPS registry.
+Optional `--aggregate-selector` and `--registry` overrides must match it.
+For the beta set, the product mapping must select
+`@yugoo-design/dsh-design-system-dsh@0.1.0-beta.1` and
+`https://registry.npmjs.org`, matching all ten owned packages' exact beta pins.
+This identifies the intended release;
+it does not establish registry availability or authorize publication. Older or unbound candidates
+retain the explicit selector and registry compatibility route. Use `--dry-run`
+first and keep its saved plan; `--apply` consumes that exact plan. Do not pass the CLI's display
+object in place of the saved plan. Output plans and result receipts are written
+outside the package, host home and pinned input directories, without replacing
+existing files. Codex-specific runtime and receipt flags do not apply here.
+
+An official package operation can fail after changing host state. The adapter
+reports `failed-partial-state-retained`, keeps its result receipt and exits
+unsuccessfully; it does not promise automatic DSH rollback, recovery or
+uninstallation. Inspect the retained state before taking another action.
+Loader/configuration readback does not establish runtime or model execution.
+This registry adapter has source-level contract coverage; it does not accept
+local tarball selectors. Before registry publication, only the supplied local
+workspace route above is available for candidate preflight. Do not substitute
+fixture selectors, `latest`, or a clone/build workflow. After publication, the
+host Agent uses registry acquisition and this mapped product adapter; the prior
+local-install result does not establish that installation or update path.
+
+## Automatic Kit discovery
+
+The distribution explicitly loads the bundled Web App and Decision Modeling
+content packages through standard Kit Loader rows, then discovers additional
+content Kits under `$DSH_HOME/design-system/kits` (default
+`~/.dsh/design-system/kits`). Each direct child is a Kit directory containing
+`mindset.md` and `skills/`. Missing roots are optional and are not created by
+the loader. Additional absolute `discoveryRoots` extend this search; they do
+not replace the default root. The source-checkout `./start.sh` also configures
+the repository `packages/` root for development-only content discovery.
+Additional user Kits placed in the default root need no per-Kit registration
+or Host source changes. Bundled Kits instead have explicit distribution dependencies
+and package-authority Loader rows; neither installation path requires start.sh.
+
+Discovery validates and registers content without executing its scripts.
+The installed catalog is shared by `/yugoo mindset <name>`, natural-language
+selection, and Studio (`followInstalledSources: true`). Native renderer/runtime
+drivers still require their own installed provider; discovery does not invent
+missing capabilities. Explicit sources load first and retain their authority;
+duplicate physical roots are skipped, and conflicting names are diagnosed
+without replacing an installed Kit. Directory ordering is deterministic.
+
+New Kits and valid edits are watched by default. Invalid edits or deleted
+sources retain process-level last-good content, including the selection
+catalog, with a diagnostic; scripts/source inspection may be unavailable after
+deletion. Existing version pins remain resolvable until shutdown. Restarting
+loads current files only: it does not restore a removed Kit from hidden storage.
+Changing a Kit's identity in-place requires a restart. `watch: false` disables
+watching and the bounded configured-root existence checks.
+
+The Portable Kernel owns Design Projects, Kit and Bundle versions, validation, execution, DesignJournal, Design Knowledge, advisories, and the shared UI. The DSH Provider maps Host identity, model-context delivery, subagents, commands, tools, and panel transport to DSH public capabilities. It exposes `ctx.userQuestions` for an in-turn blocking question when Bundle policy or the Agent requires native ask-user. Persistent asynchronous continuation appears in the plugin continuation UI, and acceptance enters as an ordinary logged user turn; advisory dispositions remain plugin-owned review decisions. Its plugin-owned binding store maps an opaque DSH Session id to the selected Design Project. No Design Project, Kit, Design File, or clarity-specific DSH Session events or projections are required; the standard `designAdvisoryInbox` projection is only a refresh/read-model mechanism and is not Design authority.
+
+Every successful `run_design_skill` completion remains attached while Core synchronously evaluates U/S/T against that exact published Git commit. The assessment is promoted to the shared project clarity authority and returned with the completed result. A bounded evaluator failure never rolls back the Bundle commit; it marks clarity failed so the main Agent cannot derive a next recommendation from stale scores. `report_design_clarity` remains the explicit main-Agent path for meaningful checkpoints outside that completion hook.
+
+Every Design Project records the exact knowledge provider in `project.json`. This DSH composition creates new projects with `ladybug-wasm` and opens that project's embedded database below its external runtime-state root, never inside the Git repository. Project switching opens and materializes the target before replacing the binding-store selection, then releases the previous handle. Provider or materialization failures leave the prior selection active and fail visibly.
+
+Grounding, reflection, and alignment are Kit-neutral built-in profiles. Successful Design publication automatically admits bounded KAG maintenance. GRA follows a separate project policy: auto combines Agent judgement with a configurable quiet merge window (default 30 seconds); continuous rechecks the latest published version every configurable N minutes (default 10), even unchanged; off disables autonomous GRA while explicit human rechecks remain available. Continuous scheduling runs online only, skips busy rounds without catch-up, and does not cancel an active reviewer. Legacy every-publication queues remain readable but are not offered in the new UI.
+
+The lightbulb Design advisories entry opens its settings even with zero suggestions. Settings persist outside Design Files; Clarity and KAG are independent. Reviewers consume bounded persisted suggestion dispositions: pending/deferred issues should not be repeated, rejection is not a permanent ban, and new evidence must explain why reconsideration is warranted. The journal suppresses exact evidence/action duplicates, not fuzzy semantic matches. No suggestion is automatically accepted or rejected.
+
+Pending targets survive restart; attempted evaluations are not automatically replayed as the same attempt. Historical results cannot update current advice, Clarity, or a newer KAG. Foreground Producer work does not block review of earlier completed designs: a running `run_design_skill` call explains editing scope, while the immutable commit boundary excludes unpublished content. The loops inherit the primary Agent's model route and credentials, never block the foreground conversation, isolate profile failures, and expose aggregate operational state through `/design status`. Grounding checks deterministic cross-file consistency, Reflection recommends Research for external-knowledge uncertainty, and Alignment routes user-only decisions through the semantic Question capability. Every loop investigates committed Design Files with read-only Git commands, may use checkpoint-matched KAG as an optional discovery aid, performs its own stale checks, and publishes without waiting for siblings. There is no atomic G/R/A set or cross-profile input flow. Selecting or closing a Design Project cancels old analysis; the binding store and DesignJournal then expose only the selected project's evidence and clarity.
+
+Design Kits are content packages managed by the Design System. They do not install or remove system capabilities. Deployment overlays may configure model providers, credentials, budgets, and other tunables, but must not reproduce this package's plugin roster.
+
+The official DSH composition enables optional native delegation through the execution plugin's `delegation` configuration. Each candidate child receives up to four structured submissions so validation feedback can repair a complex artifact within one isolated worker context. Deployments may tune the provider and resource bounds there; disabling the group leaves the Producer serial without changing completion semantics, and a rejected candidate never settles merely because its submission budget is exhausted.
+
+`pnpm run test:release:physical-distribution` at the repository root proves the isolated physical package closure: it packs this distribution and its internal packages, installs them in a consumer outside the source workspace, and rejects entry points that resolve back through the workspace. It does not install or boot an official DSH Host. The linked-profile composition gate against the pinned official DSH submodule is the official-Host compatibility check. Both gates are required before release because neither package closure nor Host compatibility implies the other.
+
+Planned Codex and Claude Code Host Providers will reuse the same Portable Kernel, projects, Kits, execution rules, and shared UI. Their first implementations discriminate the capabilities published by the installed CLI version and do not assume native programmatic questions, subagents, or panel APIs. When a CLI cannot embed the UI, its provider opens a session-bound browser companion and keeps the originating CLI as the primary Agent surface. Those providers are not implemented by this DSH package.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,35 @@
+# Third-party licensing inventory
+
+Original Yugoo-design code and documentation are licensed under Apache-2.0,
+except where otherwise identified. Third-party material retains its original
+license. This inventory is a preparation record, not a complete release SBOM
+or a substitute for license texts, source provision, or other obligations.
+
+## Known components requiring release checks
+
+| Component | License / location | Release requirement to verify |
+| --- | --- | --- |
+| Official Ladybug WASM dependency `@ladybugdb/wasm-core@0.21.1` | Package declares MIT; original text and public source locator in `third-party/native/ladybug-wasm-core-0.21.1/` | Current `packages/knowledge-ladybug` dependency route. Preserve Kùzu Inc./Ladybug Memory Inc. notices and verify actual release inclusion. The installed package has no separate third-party inventory or precise build-provenance file; embedded components and source/build correspondence remain unresolved. Package MIT is not a blanket license for the complete WASM. |
+| Historical vendored Ladybug WASM runtime | MIT; `vendor/ladybug/runtime/LICENSE` | Separate legacy route: preserve its own copyright/license, provenance and patch if distributed. Do not use its patch/source evidence as the build provenance of the official npm dependency. Compiled-in component checks remain separate. |
+| DSH code and reused utilities | MIT; `deepseek-harness/LICENSE` | Retain original notices; distinguish external host from copied/bundled utilities. |
+| Pinned DSH JSON value utility (Core) | MIT; repository `packages/core/third-party/dsh-json/LICENSE`, Core package `third-party/dsh-json/LICENSE` | Preserve the original license and provenance README with the Core tarball; verify actual packed files. |
+| ELK / elkjs | EPL-2.0 | Include license and corresponding source availability information; verify actual bundled version and modifications. |
+| sharp | Apache-2.0 | Preserve applicable license and upstream notices. |
+| Prebuilt sharp/libvips dependency bundle | Local `@img/sharp-libvips-*` package declares LGPL-3.0-or-later; contains multiple licenses | Inventory all bundled libraries per platform; provide required corresponding source/build materials and verify replacement/relinking conditions. libvips upstream alone is LGPL-2.1-or-later; do not confuse that with the distributed bundle's terms. |
+| bpmn-js | bpmn.io License | Include original license/copyright; keep the required watermark visible and unchanged. |
+| Design-style reference material and icon assets | Apache-2.0, MIT, ISC | Preserve the detailed notices in `packages/skills-web-app/skills/design_style/THIRD_PARTY_NOTICES.md`; verify required full license texts are distributed. |
+
+## Scope exclusions
+
+- `deepseek-harness/` and `vendor/ladybug/` are not relicensed by the root LICENSE.
+- External packages keep their own licenses even when bundled into an output.
+- Separately licensed Kit content and assets keep their explicit licenses.
+- Downloaded model weights require their own version-specific license review;
+  the inference engine's license does not license the weights.
+
+## Release work still pending
+
+Generate a versioned inventory from actual tarballs and CLI plugin outputs,
+include every required license/NOTICE, arrange corresponding source access for
+applicable components, and verify Linux/Windows/macOS packaging separately.
+See TODO.md. Do not label a release compliant based only on this inventory.

package/cordis.patch.yml

@@ -0,0 +1,60 @@
+- insert:
+    - id: dsh-design-core
+      name: "@yugoo-design/dsh-design-core"
+    - id: dsh-design-knowledge
+      name: "@yugoo-design/dsh-design-knowledge-ladybug/dsh"
+      config:
+        writerAttempts: 16
+        writerRetryMs: 5
+        projectLockRetries: 8
+        projectLockMinTimeoutMs: 25
+        projectLockStaleMs: 10000
+        maxQueryLimit: 1000
+        maxFilterValues: 64
+        maxTextBytes: 16384
+        maxImpactDepth: 8
+        maxImpactSeeds: 128
+        maxArchiveRecords: 100000
+    - id: dsh-design-provider-web-app
+      name: "@yugoo-design/dsh-design-provider-web-app"
+    - id: dsh-design-kit-decision-modeling
+      name: "@yugoo-design/dsh-design-core/kit-loader"
+      config:
+        packageName: "@yugoo-design/dsh-design-skills-decision-modeling"
+    - id: dsh-design-kit-web-app
+      name: "@yugoo-design/dsh-design-core/kit-loader"
+      config:
+        packageName: "@yugoo-design/dsh-design-skills-web-app"
+        discoveryRoots: []
+    - id: dsh-design-advisory-scheduler
+      name: "@yugoo-design/dsh-design-core/advisory-scheduler"
+      config:
+        provider: spawn
+        debounceMs: 30000
+        maxSuggestions: 5
+    - id: dsh-design-execution
+      name: "@yugoo-design/dsh-design-core/execution"
+      config:
+        producerMaxTokens: 16384
+        producerMaxDepth: 4
+        delegation:
+          provider: dsh-design-file-worker
+          maxDepth: 4
+          maxTokens: 32768
+          maxConcurrency: 4
+        maxArtifactInputFiles: 64
+        maxArtifactInputPathBytes: 512
+        maxArtifactInputFileBytes: 262144
+        maxArtifactInputTotalBytes: 2097152
+    - id: dsh-design-panel-remote
+      name: "@yugoo-design/dsh-design-core/panel-remote"
+      config:
+        maxBinaryArtifactBytes: 26214400
+    - id: dsh-design-panel
+      name: "@yugoo-design/dsh-design-panel"
+    - id: dsh-design-studio
+      name: "@yugoo-design/dsh-design-studio-dsh"
+      config:
+        followInstalledSources: true
+    - id: dsh-design-studio-page
+      name: "@yugoo-design/dsh-design-studio-dsh/studio-page"

package/index.js

@@ -0,0 +1,2 @@
+/** Package marker for the single-install Design System configuration bundle. */
+export function apply() {}

package/licenses/dsh-distribution.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "package": "@yugoo-design/dsh-design-system-dsh",
+  "scope": "observed-current-dsh-output-and-selected-original-materials",
+  "sourceArchiveObserved": null,
+  "outputSha256": {
+    "index.js": "6ec94e30318c4c9bf77fbdfe4d8b768007cd189a3fde40fa0a5b8dbad55fa283"
+  },
+  "normalBuildMaps": [],
+  "components": [],
+  "fonts": [],
+  "embeddedBpmnFonts": [],
+  "unresolvedEmbeddedFonts": [],
+  "externalDependencies": {},
+  "externalPeers": {},
+  "copiedMaterials": {},
+  "limitations": [
+    "This component list is scoped to retained maps whose output was compared to actual adapted archive bytes, and emitted source-region IDs; no complete coverage claim for generated/unmapped code.",
+    "External npm dependencies and peer host services are separate artifacts, even where other modules from that package are embedded.",
+    "Shared Radix/upstream attribution records keep their original historical-source limitations.",
+    "Existing embedded/font/native source obligations and rendering checks remain distinct from delivery of original license text."
+  ],
+  "completeBundledInventoryVerified": false,
+  "releaseLicenseAcceptance": false
+}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@yugoo-design/dsh-design-system-dsh",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-beta.1",
+  "license": "Apache-2.0",
+  "type": "module",
+  "description": "Yugoo Design (yugoo-design) installation plugin for DeepSeek Harness.",
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES.md",
+    "licenses"
+  ],
+  "dependencies": {
+    "@yugoo-design/dsh-design-core": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-knowledge-ladybug": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-panel": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-provider-web-app": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-studio-dsh": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-skills-web-app": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-skills-decision-modeling": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-studio": "0.1.0-beta.1",
+    "@yugoo-design/dsh-design-studio-ui": "0.1.0-beta.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}