@yugoo-design/dsh-design-system-dsh 0.1.2 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +85 -17
  2. package/cordis.patch.yml +2 -0
  3. package/package.json +17 -11
package/README.md CHANGED
@@ -1,9 +1,19 @@
1
1
  # Yugoo Design for DeepSeek Harness
2
2
 
3
- This package owns the internal DeepSeek Harness installation bundle for Yugoo
4
- Design. Users acquire the unified `yugoo-design` product, whose DSH adapter
5
- installs the exact aggregate and internal modules. The first stable product
6
- release, `0.1.0`, is published to npm; acquire the requested exact release.
3
+ Yugoo Design turns your DeepSeek Harness conversation into an interactive
4
+ workspace for ideation and design, with editable panels, structured knowledge
5
+ and guided iteration.
6
+
7
+ To install or update, give the [DSH installation guide](../companion/HOSTS.md#install-or-update-deepseek-harness)
8
+ to the Agent in your existing DSH conversation. It acquires the unified
9
+ `yugoo-design` product from npm and uses the product's release mapping to install
10
+ this aggregate and its internal modules. Request an exact published version, or
11
+ let the Agent resolve `latest` once and use that exact version for the operation.
12
+ Existing projects and host model/search settings must be preserved.
13
+
14
+ This README describes the DSH integration and its development references. The
15
+ historical checks below retain their original versions; use the selected
16
+ release's guide and manifest for a new installation.
7
17
 
8
18
  Official DSH is a read-only Host compatibility target. This package uses public
9
19
  Cordis, command, tool, Agent, interaction, subagent, Remote, and client-module
@@ -34,6 +44,23 @@ new shared runtime component or native UI surface requires a runtime release.
34
44
  Installed-package native-equivalence acceptance remains separate from this
35
45
  source declaration and is not established by the presence of 15 definitions.
36
46
 
47
+ File Workers negotiate the installed Host's public capabilities. Legacy Hosts
48
+ use their one-shot Subagent Runtime; RC3 uses the public Agent factory, as the
49
+ attached Producer and read-only reviewers do. Each Worker retains its exact
50
+ artifact grant, parent model route, depth limit and cancellation. Factory
51
+ children have real native Sessions and tool logs; they do not claim the
52
+ Subagent Runtime's manager catalog, events or capacity pool. A failed start is
53
+ reported rather than retried through a different backend.
54
+
55
+ Each configured Design Project owns one complete current definition tree at
56
+ `design_kit/`, separate from its design data in `design_files/`. Methods,
57
+ schemas, Panels, resources and scripts load from that project's Kit and mounted
58
+ Bundles. The library supplies the initial copy for a new project. Later library
59
+ edits do not replace existing project customizations; ask the Agent to compare
60
+ and apply wanted changes through the ordinary edit/validate/save/Git path.
61
+ Local content requires no release, version switch, upgrade wizard or remount.
62
+ Design data publication, human handoff and npm versions remain distinct.
63
+
37
64
  ## Daily entry
38
65
 
39
66
  DSH Web and Desktop use the same Core message producers. Plugin-authored
@@ -67,9 +94,17 @@ unchanged.
67
94
 
68
95
  ## Installation target and current package composition
69
96
 
70
- The product name is **Yugoo Design**. Source package and Loader identifiers remain
71
- `dsh-design-*`; public npm exports use the `@yugoo-design` scope. The brand does
72
- not rename imports or Loader identities.
97
+ The product name is **Yugoo Design**. The single installation aggregate uses
98
+ `@yugoo-design/dsh-design-system-dsh` in both source and public npm metadata.
99
+ The other nine source packages and Loader identities keep their existing names;
100
+ their public npm exports use the `@yugoo-design` scope. Service and RPC identities
101
+ remain unchanged.
102
+ Linked source profiles that used the former unscoped aggregate name need an
103
+ explicit update of that dependency and bundle reference. A source change does
104
+ not migrate an existing profile; published scoped consumers keep their package
105
+ identity. Source workspace dependencies still require the normal release
106
+ assembly before registry installation.
107
+
73
108
  Official DSH is an external, separately installed host and is not one of the
74
109
  plugin's system packages. Its agents supply generative model execution, questions,
75
110
  subagents and search; installing this plugin must preserve the user's existing
@@ -78,20 +113,24 @@ Design Knowledge uses a separate local CPU embedding model; it does not require
78
113
  a GPU or replace the host's generative models.
79
114
 
80
115
  The source composition has six direct dependencies (Core, Knowledge, Panel,
81
- Web App provider, Web App content, and DSH Studio integration) and ten Loader
116
+ Web App provider, Web App content, and DSH Studio integration) and eleven Loader
82
117
  rows. The complete Yugoo dependency closure contains the ten packages below;
83
118
  transitive dependencies remain owned by their consuming packages, not added as
84
119
  aggregate dependencies merely because they occur in a release inventory.
85
120
  The npm aggregate additionally supplies the two required Studio/Studio UI peers
86
121
  reached from this closure because DSH disables automatic peer installation.
87
122
  It does not install unrelated or optional peers from the release inventory.
123
+ The Studio authoring row mounts the existing shared working-copy Service and
124
+ Host conversation tool. The current conversation's Studio launcher supplies its
125
+ exact Session locator for AI-assisted customization; Settings remains a
126
+ session-free inspection entry. No model is invoked merely by activating the row.
88
127
  The selected release manifest fixes exact dependency versions.
89
128
  The directory column identifies the existing source package, not an end-user
90
129
  checkout or build requirement.
91
130
 
92
131
  | Package identifier | Source directory | Role |
93
132
  | --- | --- | --- |
94
- | `dsh-design-system-dsh` | `packages/dsh` | DSH installation bundle and Loader registration |
133
+ | `@yugoo-design/dsh-design-system-dsh` | `packages/dsh` | DSH installation bundle and Loader registration |
95
134
  | `dsh-design-core` | `packages/core` | Design state, Bundle execution and validation |
96
135
  | `dsh-design-panel` | `packages/panel` | Shared Panel runtime and components |
97
136
  | `dsh-design-knowledge-ladybug` | `packages/knowledge-ladybug` | Design Knowledge provider |
@@ -292,7 +331,7 @@ Have your host agent perform these steps using recipient-owned absolute paths:
292
331
  existing model, search and credential configuration.
293
332
  2. Verify every archive against `PORTABLE-INPUTS.json`. Safely extract its
294
333
  compiled `package/` contents into the profile's `packages/<package-name>`
295
- directory, using the unscoped name (for example,
334
+ directory, using the package basename as its directory label (for example,
296
335
  `profiles/yugoo-local/packages/dsh-design-core`). Reject absolute/traversing
297
336
  paths, links and special archive members;
298
337
  verify the unchanged extracted package name and version. Do not rewrite them.
@@ -411,9 +450,9 @@ and release.
411
450
 
412
451
  ### Candidate npm installer: DSH route and recovery limits
413
452
 
414
- The product CLI route is `install --host dsh`; the historical Companion
415
- `0.1.0-beta.3` was an earlier distribution of this adapter. The unified
416
- `yugoo-design@0.1.0` product is published. This is an installer adapter
453
+ The product CLI route is `install --host dsh`. Acquire the selected exact
454
+ published `yugoo-design` version using the shared installation guide; the older
455
+ Companion package versions remain in the historical checks below. This is an installer adapter
417
456
  for the separately installed official DSH
418
457
  host, not a bundled DSH application or a desktop Companion runtime inside DSH.
419
458
  Yugoo Design has one product installation entry. For DSH, that entry installs
@@ -444,10 +483,26 @@ object in place of the saved plan. Output plans and result receipts are written
444
483
  outside the package, host home and pinned input directories, without replacing
445
484
  existing files. Codex-specific runtime and receipt flags do not apply here.
446
485
 
486
+ During a native package operation, pnpm may append `minimumReleaseAgeExclude`
487
+ entries for newly published dependencies. The adapter accepts only exact
488
+ `name@version` additions reachable through the selected installed aggregate's
489
+ exact runtime dependency declarations. Existing exclusions and all other
490
+ workspace settings must remain unchanged; ranges, wildcards, unrelated packages,
491
+ removed exclusions and other configuration changes still fail preservation.
492
+ The receipt's `configurationChanges` records accepted additions and changed
493
+ configuration paths without replacing the original before/after hashes.
494
+
447
495
  An official package operation can fail after changing host state. The adapter
448
496
  reports `failed-partial-state-retained`, keeps its result receipt and exits
449
497
  unsuccessfully; it does not promise automatic DSH rollback, recovery or
450
- uninstallation. Inspect the retained state before taking another action.
498
+ uninstallation. The receipt's `failure.reasons`, configuration comparison and
499
+ retained command logs distinguish native command failure, configuration changes
500
+ and incomplete registration. Inspect them and the existing official DSH Plugins
501
+ interface before using the host plugin manager to repair the specific state.
502
+ Do not reapply the failed plan or pass a failed receipt as `--previous-receipt`.
503
+ DSH has no installer recovery/adoption route: restarting or observing an already
504
+ registered package cannot establish the failed transaction's ownership. Keep
505
+ the existing profile, configuration and projects while investigating.
451
506
  Loader/configuration readback does not establish runtime or model execution.
452
507
  This registry adapter has source-level contract coverage; it does not accept
453
508
  local tarball selectors. Before registry publication, only the supplied local
@@ -481,8 +536,16 @@ without replacing an installed Kit. Directory ordering is deterministic.
481
536
  New Kits and valid edits are watched by default. Invalid edits or deleted
482
537
  sources retain process-level last-good content, including the selection
483
538
  catalog, with a diagnostic; scripts/source inspection may be unavailable after
484
- deletion. Existing version pins remain resolvable until shutdown. Restarting
485
- loads current files only: it does not restore a removed Kit from hidden storage.
539
+ deletion. Unaccepted development versions remain process-local; restarting loads
540
+ their current source files. Before project selection, source migration or an
541
+ explicit content upgrade accepts a file-backed Kit, DSH retains its complete
542
+ exact Kit/Bundle closure through the existing immutable content store. A failed
543
+ retention or same-pin content conflict leaves the project pin unchanged.
544
+ Accepted closures remain resolvable after source upgrades, removal and restart.
545
+ They use Core's `contentStateRoot`, which defaults to its existing `stateRoot`;
546
+ the loader restores the same root automatically. An older explicit loader
547
+ `contentStateRoot` remains readable, while new acceptances use the Core root.
548
+ Native contributions still require their original trusted installed provider.
486
549
  Changing a Kit's identity in-place requires a restart. `watch: false` disables
487
550
  watching and the bounded configured-root existence checks.
488
551
 
@@ -538,7 +601,12 @@ The official DSH composition enables optional native delegation through the exec
538
601
 
539
602
  `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.
540
603
 
541
- 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.
604
+ Other supported hosts, including Codex and Claude Code, use the
605
+ [Companion adapters](../companion/HOSTS.md), which reuse the shared Core,
606
+ projects, Kits, execution rules and UI. The installed host's capabilities
607
+ determine available questions, subagents and page presentation; a CLI can use a
608
+ session-bound browser while retaining its original conversation as the primary
609
+ Agent surface. Those adapters are not implemented by this DSH package.
542
610
 
543
611
  ## Historical release checks
544
612
 
package/cordis.patch.yml CHANGED
@@ -54,3 +54,5 @@
54
54
  followInstalledSources: true
55
55
  - id: dsh-design-studio-page
56
56
  name: "@yugoo-design/dsh-design-studio-dsh/studio-page"
57
+ - id: dsh-design-studio-authoring
58
+ name: "@yugoo-design/dsh-design-studio-dsh/authoring-entry"
package/package.json CHANGED
@@ -1,9 +1,7 @@
1
1
  {
2
2
  "name": "@yugoo-design/dsh-design-system-dsh",
3
- "version": "0.1.2",
3
+ "version": "0.2.2",
4
4
  "license": "Apache-2.0",
5
- "type": "module",
6
- "description": "Yugoo Design (yugoo-design) installation plugin for DeepSeek Harness.",
7
5
  "repository": {
8
6
  "type": "git",
9
7
  "url": "git+https://github.com/alibaba-damo-academy/yugoo-design.git",
@@ -13,6 +11,14 @@
13
11
  "bugs": {
14
12
  "url": "https://github.com/alibaba-damo-academy/yugoo-design/issues"
15
13
  },
14
+ "keywords": [
15
+ "dsh-plugin",
16
+ "yugoo-design",
17
+ "design-system",
18
+ "interactive-design"
19
+ ],
20
+ "type": "module",
21
+ "description": "Yugoo Design (yugoo-design) installation plugin for DeepSeek Harness.",
16
22
  "exports": {
17
23
  ".": "./index.js",
18
24
  "./package.json": "./package.json"
@@ -32,14 +38,14 @@
32
38
  "licenses"
33
39
  ],
34
40
  "dependencies": {
35
- "@yugoo-design/dsh-design-core": "0.1.2",
36
- "@yugoo-design/dsh-design-knowledge-ladybug": "0.1.2",
37
- "@yugoo-design/dsh-design-panel": "0.1.2",
38
- "@yugoo-design/dsh-design-provider-web-app": "0.1.2",
39
- "@yugoo-design/dsh-design-studio-dsh": "0.1.2",
40
- "@yugoo-design/dsh-design-skills-web-app": "0.1.2",
41
- "@yugoo-design/dsh-design-studio": "0.1.2",
42
- "@yugoo-design/dsh-design-studio-ui": "0.1.2"
41
+ "@yugoo-design/dsh-design-core": "0.2.2",
42
+ "@yugoo-design/dsh-design-knowledge-ladybug": "0.2.2",
43
+ "@yugoo-design/dsh-design-panel": "0.2.2",
44
+ "@yugoo-design/dsh-design-provider-web-app": "0.2.2",
45
+ "@yugoo-design/dsh-design-studio-dsh": "0.2.2",
46
+ "@yugoo-design/dsh-design-skills-web-app": "0.2.2",
47
+ "@yugoo-design/dsh-design-studio": "0.2.2",
48
+ "@yugoo-design/dsh-design-studio-ui": "0.2.2"
43
49
  },
44
50
  "publishConfig": {
45
51
  "access": "public"