@lincyaw/dsh 0.1.0 → 0.2.0-rc.1

package/README.md

@@ -1,12 +1,14 @@
 # @lincyaw/dsh
 
-Presmium's bundle for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (MIT): Presmium's workbench as a DeepSeek Harness distribution. Its host side keeps web sessions at the workspace root with read/write access throughout that directory. Selecting a lecture updates Presmium's document tools and context without changing the session or its working directory. It also provides Presmium's approval policy, authoring skills, and the workbench's data routes. Its client side (`./client`, precompiled) replaces DeepSeek Harness's layout with Presmium's (activity bar, file tree, source editor, problems and live preview, the conversation docked at the right), maps its colours onto Presmium's and puts Presmium's brand in its places. Experimental (0.x): it follows one exact version of DeepSeek Harness, `0.2.1-alpha.4`.
+Presmium's bundle for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (MIT): Presmium's workbench as a DeepSeek Harness distribution. Its host side keeps web sessions at the workspace root with read/write access throughout that directory. Selecting a lecture updates Presmium's document tools and context without changing the session or its working directory. It also provides Presmium's approval policy, authoring skills, and the workbench's data routes. Its client side (`./client`, precompiled) replaces DeepSeek Harness's layout with Presmium's (the documents, a document edited on its rendered page with comments and version history, the AI assistant docked at the right), maps its colours onto Presmium's and puts Presmium's brand in its places. Experimental (0.x): it follows one exact version of DeepSeek Harness, `0.2.1-alpha.4`.
 
-Part of [Presmium](https://github.com/Lincyaw/presmium), which turns lectures written in MyST Markdown into web pages, slides, Jupyter notebooks and narrated lectures.
+Part of [Presmium](https://github.com/Lincyaw/presmium), which compiles canonical lecture.json teaching documents into web pages, slides, Jupyter notebooks and narrated playback.
 
 ## Usage
 
-`presmium studio` installs and starts it; you do not add it yourself. A launcher of its own writes a profile with `@lincyaw/dsh/launch` (`writeProfile`), passes the patches `launchPatches(carrier)` returns with `--patch`, and sets `launchEnv(dshHome)`; with `PRESMIUM_SERVICE_URL` and `PRESMIUM_SERVICE_TOKEN` it uses that workspace service, otherwise it starts `presmium serve` itself.
+`presmium studio` installs and starts it; you do not add it yourself. A launcher of its own writes a profile with `@lincyaw/dsh/launch` (`writeProfile`), passes the patches `launchPatches(carrier)` returns with `--patch`, and sets `launchEnv(dshHome)`; it can start the workspace service as studio does with `launchWorkspaceServer`. With `PRESMIUM_SERVICE_URL` and `PRESMIUM_SERVICE_TOKEN` the bundle uses that workspace service, otherwise it starts `presmium serve` itself in the same way.
+
+To collect usage for analysis, set `PRESMIUM_TELEMETRY_URL` to your OTLP/HTTP logs endpoint (for example `http://collector:4318/v1/logs`) in the environment that starts the studio, with `PRESMIUM_TELEMETRY_HEADERS` (`key=value,…`, values URL-encoded) for its authorization and optionally `PRESMIUM_TELEMETRY_USER` as the resource's `user.id`. The bundle then exports every event of every session as `session-log` records, and the author's operations in the workbench as `presmium.workbench.<operation>` events; a request handed to the AI carries `dsh.request.id`, the id its user message carries in the session, which leads to the turn it started. Without the URL nothing is recorded or sent. DeepSeek Harness's own telemetry stays off.
 
 In a checkout of the repository the client bundle is built when DeepSeek Harness starts and its sources are newer (`build/ensure.mjs`); `node build/client.mjs` builds it by hand, and packing the package (`prepack`) builds it for publishing.
 
@@ -16,7 +18,9 @@ Presmium provides one navigation shell and composes Harness's session browser an
 
 ## Documentation
 
-- [Design of the workbench on DeepSeek Harness](https://github.com/Lincyaw/presmium/blob/main/docs/design-dsh.md)
+Studio keeps the teaching workflow simple: describe a change, inspect its preview, select the relevant content and review the agent's edit. Full code editing can use the VS Code extension. Each agent step receives current document, focus and bounded browser feedback. `presmium__get_diagnostics` reads the same bounded diagnostic snapshot as the workbench without compiling; `presmium__check_document` explicitly runs compilation and plugin checks; `presmium__get_outputs` reads compiled recordings, and `presmium__get_runtime` reads reported browser failures, live code results and session resets. These reports are observations, not verification of newly edited source; rerun affected code after a change. No author window means no browser feedback is available.
+
+- [Design of the workbench on DeepSeek Harness](https://github.com/Lincyaw/presmium/blob/main/docs/studio.md)
 
 ## License
 

package/build/client.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { renameSync, mkdirSync, writeFileSync } from 'node:fs'
+import { chmodSync, renameSync, mkdirSync, writeFileSync } from 'node:fs'
 import { join, relative } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { SHELL_MODULES } from '../src/client/contract.ts'
@@ -20,6 +20,9 @@ const noWoffFallback = {
 function writeWhole(file, text) {
   const temporary = `${file}.${process.pid}.${Date.now()}.tmp`
   writeFileSync(temporary, text)
+  // Build outputs are public client assets shared by local source-checkout users.
+  // A private launcher umask must not make the bundle or its input manifest unreadable.
+  chmodSync(temporary, 0o644)
   renameSync(temporary, file)
 }
 
@@ -32,6 +35,7 @@ export async function buildClient() {
     minify: true,
     metafile: true,
     absWorkingDir: PACKAGE,
+    conditions: ['style'],
     loader: { '.woff2': 'dataurl' },
     plugins: [noWoffFallback],
     logLevel: 'warning',
@@ -49,6 +53,8 @@ export async function buildClient() {
     legalComments: 'none',
     metafile: true,
     external: [...SHELL_MODULES],
+    // the mascot's sprite sheets travel inside the single client file
+    loader: { '.png': 'dataurl' },
     define: { '__PRESMIUM_CSS__': JSON.stringify(css.outputFiles[0].text), 'process.env.NODE_ENV': '"production"' },
     logLevel: 'warning',
   })