dsh-brief-sidebar 0.3.0 → 0.4.0

package/package.json

@@ -1,94 +1,106 @@
-{
-  "name": "dsh-brief-sidebar",
-  "version": "0.3.0",
-  "description": "DSH web plugin (dsh-better-sidebar consumer): render the session brief — the todo list (the `todos` projection board) plus the artifact list (a live produced-files feed, codeplan artifacts marked) — as a summary tab in the right sidebar, and shadow the official composer-band todo panel so the board is the single visible carrier. Read-only.",
-  "type": "module",
-  "main": "lib/index.mjs",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.mjs"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "src",
-    "cordis.patch.yml",
-    "dsh.plugin.json",
-    "README.md"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ]
-    }
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "better-sidebar",
-    "brief",
-    "todo",
-    "artifact-list",
-    "task-board",
-    "summary",
-    "deliverables"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20",
-    "dsh": ">=0.1.5-rc.1 <0.2.0-0"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "dsh-better-sidebar": ">=0.18.1",
-    "react": "^18.2.0"
-  },
-  "peerDependenciesMeta": {
-    "dsh-better-sidebar": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    }
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && tsdown --config-loader tsx",
-    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.client.json",
-    "test": "vitest run",
-    "clean": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\"",
-    "prepublishOnly": "npm run build"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@types/node": "^22.0.0",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "~18.3.7",
-    "dsh-better-sidebar": "^0.19.1",
-    "jsdom": "^26.0.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "tsdown": "^0.22.2",
-    "tsx": "^4.23.12",
-    "typescript": "^5.6.0",
-    "vitest": "^3.0.0",
-    "zod": "^4.4.3"
-  }
-}
+{
+  "name": "dsh-brief-sidebar",
+  "version": "0.4.0",
+  "description": "DSH web plugin (dsh-better-sidebar consumer): render the session brief — the todo list (the `todos` projection board) plus the artifact list (a live produced-files feed, codeplan artifacts marked) — as a summary tab in the right sidebar, and shadow the official composer-band todo panel so the board is the single visible carrier. Read-only.",
+  "type": "module",
+  "main": "lib/index.mjs",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.mjs"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "assets",
+    "screenshots.json",
+    "cordis.patch.yml",
+    "dsh.plugin.json",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "better-sidebar",
+    "brief",
+    "todo",
+    "artifact-list",
+    "task-board",
+    "summary",
+    "deliverables"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drscrewdriver/dsh-brief-sidebar.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public",
+    "tag": "dsh-0.1.5"
+  },
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.2.0-rc.1 <0.2.1-0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-locale": ">=0.2.0-rc.1 <0.2.1-0",
+    "dsh-better-sidebar": ">=0.18.1",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "dsh-better-sidebar": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && tsdown --config-loader tsx",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.client.json",
+    "test": "vitest run",
+    "clean": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run build",
+    "release:015": "npm publish --tag dsh-0.1.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@types/node": "^22.0.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.7",
+    "dsh-better-sidebar": "^0.19.1",
+    "jsdom": "^26.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.2",
+    "tsx": "^4.23.12",
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0",
+    "zod": "^4.4.3"
+  }
+}

package/screenshots.json

@@ -0,0 +1,5 @@
+{
+  "screenshots": [
+    "assets/brief.png"
+  ]
+}

package/src/client/BriefIcon.tsx

@@ -1,56 +1,56 @@
-/**
- * Tab glyph for the task board.
- *
- * Skin contract: plugin-drawn glyphs take their colour from the `--dsw-alias-*`
- * tokens — no colour literals anywhere in this file.
- */
-import type { ReactNode } from 'react'
-
-/**
- * A checklist mark: three rows with ticks and text rails — the same status
- * vocabulary the board paints.
- * @param size - square edge in px (the host passes its own tab-icon size).
- */
-export function BriefIcon(size: number): ReactNode {
-  return (
-    <svg
-      width={size}
-      height={size}
-      viewBox="0 0 16 16"
-      fill="none"
-      aria-hidden="true"
-      focusable="false"
-      style={{ display: 'block', flex: 'none' }}
-    >
-      <rect
-        x={1.6}
-        y={2.4}
-        width={12.8}
-        height={11.2}
-        rx={2}
-        stroke="var(--dsw-alias-label-tertiary)"
-        strokeWidth={1.2}
-      />
-      <path
-        d="M4.2 6.1l1 1 1.8-2"
-        stroke="var(--dsw-alias-state-success-primary)"
-        strokeWidth={1.3}
-        strokeLinecap="round"
-        strokeLinejoin="round"
-      />
-      <path
-        d="M4.2 10.6l1 1 1.8-2"
-        stroke="var(--dsw-alias-label-tertiary)"
-        strokeWidth={1.3}
-        strokeLinecap="round"
-        strokeLinejoin="round"
-      />
-      <path
-        d="M8.4 6.4h4M8.4 10.9h4"
-        stroke="var(--dsw-alias-label-tertiary)"
-        strokeWidth={1.2}
-        strokeLinecap="round"
-      />
-    </svg>
-  )
-}
+/**
+ * Tab glyph for the task board.
+ *
+ * Skin contract: plugin-drawn glyphs take their colour from the `--dsw-alias-*`
+ * tokens — no colour literals anywhere in this file.
+ */
+import type { ReactNode } from 'react'
+
+/**
+ * A checklist mark: three rows with ticks and text rails — the same status
+ * vocabulary the board paints.
+ * @param size - square edge in px (the host passes its own tab-icon size).
+ */
+export function BriefIcon(size: number): ReactNode {
+  return (
+    <svg
+      width={size}
+      height={size}
+      viewBox="0 0 16 16"
+      fill="none"
+      aria-hidden="true"
+      focusable="false"
+      style={{ display: 'block', flex: 'none' }}
+    >
+      <rect
+        x={1.6}
+        y={2.4}
+        width={12.8}
+        height={11.2}
+        rx={2}
+        stroke="var(--dsw-alias-label-tertiary)"
+        strokeWidth={1.2}
+      />
+      <path
+        d="M4.2 6.1l1 1 1.8-2"
+        stroke="var(--dsw-alias-state-success-primary)"
+        strokeWidth={1.3}
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+      <path
+        d="M4.2 10.6l1 1 1.8-2"
+        stroke="var(--dsw-alias-label-tertiary)"
+        strokeWidth={1.3}
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+      <path
+        d="M8.4 6.4h4M8.4 10.9h4"
+        stroke="var(--dsw-alias-label-tertiary)"
+        strokeWidth={1.2}
+        strokeLinecap="round"
+      />
+    </svg>
+  )
+}

package/src/client/SummaryTab.tsx

@@ -1,73 +1,73 @@
-/**
- * The summary tab body: the session's at-a-glance state, composed of sections.
- *
- * Section order: 进展 (the todos board) → 产物 (produced files, codeplan
- * artifacts marked inline) → the reserved memory-recall slot (see below).
- * Each section owns its own data chain and its own three-state contract; this
- * component owns only the shell.
- *
- * Two better-sidebar contracts are honoured:
- *
- * 1. **Height contract.** The tab body mounts inside a full-height column flex
- *    host whose `.paneBody` is a definite-height BLOCK scroll container. The
- *    root declares `height: 100%` + `min-height: 0`, and the scrolling element
- *    is an inner div — not the root. Sections are non-scrolling slices with a
- *    bottom border; the inner div scrolls them all.
- * 2. **`visible` pause.** Nothing is drawn while the tab is not the active
- *    one, so a hidden tab does not re-render on every projection frame.
- */
-import { createElement } from 'react'
-import type { CSSProperties, ReactNode } from 'react'
-import type { Context } from '@deepseek-ai/cordis'
-import { TodoSection } from './TodoBoardTab'
-import type { TodoScope } from './TodoBoardTab'
-import { DeliverablesSection } from './summary/DeliverablesSection'
-
-export interface SummaryTabProps {
-  /** The DSH locale lookup, passed down from `apply`. */
-  t: (key: string) => string
-  /** The client root context (the tab body's only way to reach services). */
-  ctx?: Context
-  /** The session this tab is scoped to. */
-  scope?: TodoScope
-  /** Whether the tab is the active one AND the panel is open. */
-  visible?: boolean
-}
-
-const ROOT_STYLE: CSSProperties = {
-  display: 'flex',
-  flexDirection: 'column',
-  height: '100%',
-  minHeight: 0,
-  background: 'var(--dsw-alias-bg-layer-1)',
-  color: 'var(--dsw-alias-label-primary)',
-  font: 'inherit',
-  fontSize: 13,
-}
-
-const SCROLL_STYLE: CSSProperties = { flex: 1, minHeight: 0, overflow: 'auto' }
-
-/**
- * The summary tab.
- * @param props - translation, client context, session scope, visibility.
- */
-export function SummaryTab(props: SummaryTabProps): ReactNode {
-  const { t, ctx, scope, visible = true } = props
-
-  // A hidden tab renders NOTHING — not even the shell — so it never
-  // re-renders on a projection frame while it is off screen.
-  if (!visible) return null
-
-  return createElement(
-    'div',
-    { style: ROOT_STYLE, 'data-dsh-brief-sidebar': 'board' },
-    createElement('div', { style: SCROLL_STYLE },
-      createElement(TodoSection, { key: 'progress', t, ctx, scope }),
-      createElement(DeliverablesSection, { key: 'deliverables', t, ctx, scope }),
-      // 记忆召回插槽（远期，固定最底）：概要从两区扩为三区时，记忆召回分区
-      // 排在这里。系统中没有默认记忆，数据链等记忆类插件注册自己的投影 key
-      // 后经同一个 `faceOf` 通道接入（`useProjectionValue`），本期不渲染。
-      null,
-    ),
-  )
-}
+/**
+ * The summary tab body: the session's at-a-glance state, composed of sections.
+ *
+ * Section order: 进展 (the todos board) → 产物 (produced files, codeplan
+ * artifacts marked inline) → the reserved memory-recall slot (see below).
+ * Each section owns its own data chain and its own three-state contract; this
+ * component owns only the shell.
+ *
+ * Two better-sidebar contracts are honoured:
+ *
+ * 1. **Height contract.** The tab body mounts inside a full-height column flex
+ *    host whose `.paneBody` is a definite-height BLOCK scroll container. The
+ *    root declares `height: 100%` + `min-height: 0`, and the scrolling element
+ *    is an inner div — not the root. Sections are non-scrolling slices with a
+ *    bottom border; the inner div scrolls them all.
+ * 2. **`visible` pause.** Nothing is drawn while the tab is not the active
+ *    one, so a hidden tab does not re-render on every projection frame.
+ */
+import { createElement } from 'react'
+import type { CSSProperties, ReactNode } from 'react'
+import type { Context } from '@deepseek-ai/cordis'
+import { TodoSection } from './TodoBoardTab'
+import type { TodoScope } from './TodoBoardTab'
+import { DeliverablesSection } from './summary/DeliverablesSection'
+
+export interface SummaryTabProps {
+  /** The DSH locale lookup, passed down from `apply`. */
+  t: (key: string) => string
+  /** The client root context (the tab body's only way to reach services). */
+  ctx?: Context
+  /** The session this tab is scoped to. */
+  scope?: TodoScope
+  /** Whether the tab is the active one AND the panel is open. */
+  visible?: boolean
+}
+
+const ROOT_STYLE: CSSProperties = {
+  display: 'flex',
+  flexDirection: 'column',
+  height: '100%',
+  minHeight: 0,
+  background: 'var(--dsw-alias-bg-layer-1)',
+  color: 'var(--dsw-alias-label-primary)',
+  font: 'inherit',
+  fontSize: 13,
+}
+
+const SCROLL_STYLE: CSSProperties = { flex: 1, minHeight: 0, overflow: 'auto' }
+
+/**
+ * The summary tab.
+ * @param props - translation, client context, session scope, visibility.
+ */
+export function SummaryTab(props: SummaryTabProps): ReactNode {
+  const { t, ctx, scope, visible = true } = props
+
+  // A hidden tab renders NOTHING — not even the shell — so it never
+  // re-renders on a projection frame while it is off screen.
+  if (!visible) return null
+
+  return createElement(
+    'div',
+    { style: ROOT_STYLE, 'data-dsh-brief-sidebar': 'board' },
+    createElement('div', { style: SCROLL_STYLE },
+      createElement(TodoSection, { key: 'progress', t, ctx, scope }),
+      createElement(DeliverablesSection, { key: 'deliverables', t, ctx, scope }),
+      // 记忆召回插槽（远期，固定最底）：概要从两区扩为三区时，记忆召回分区
+      // 排在这里。系统中没有默认记忆，数据链等记忆类插件注册自己的投影 key
+      // 后经同一个 `faceOf` 通道接入（`useProjectionValue`），本期不渲染。
+      null,
+    ),
+  )
+}