dsh-plugin-logicmargin 0.0.0-stage → 0.9.18

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LogicMargin 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

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# LogicMargin 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.
+Connect source-backed logic diagrams, saved code diffs, and human review feedback to **DSH 0.2.2-rc.1**. This thin host plugin uses DSH's official MCP Client and filesystem skill provider. It starts or reuses LogicMargin's native Go service; users do not install Go or a second Node runtime.
+
+The distributable is generated from the repository with `npm run package:dsh`. It includes the fixed-version native download launchers and a DSH-specific skill generated from the shared review workflow. Installing this source directory directly is not supported.
+
+## Install a built package
+
+For the profile you actually use:
+
+```sh
+dsh plugin --profile YOUR_PROFILE add /absolute/path/dsh-plugin-logicmargin-0.9.18.tgz
+```
+
+Reload the plugin/profile, verify the `logic-margin` skill, and verify `mcp__logic_margin__start_review` and `mcp__logic_margin__wait_review`. Use the skill in the original workspace. Installation alone is not proof that tools are loaded.
+
+The first activation downloads the matching official LogicMargin 0.9.18 release and verifies SHA-256. macOS/Linux need `curl`, `unzip`, and `shasum` or `sha256sum`; Windows uses PowerShell. Git and compilers are not required. Native availability matches the five LogicMargin targets: macOS ARM64/x64, Linux ARM64/x64, Windows x64.
+
+The default reuses the same user's compatible local LogicMargin service. Optional plugin config fields are `home` (an absolute path) and `port` (0–65535). A separate home isolates the daemon registry; its data defaults to `<home>/sessions`, unless the host explicitly supplies `LOGIC_MARGIN_DATA_DIR`. Existing daemons retain their registered data directory. A conflicting or incompatible daemon fails explicitly; this plugin does not stop or replace it.
+
+MCP waits have a 24-hour per-call budget, not a promise of durable or infinite execution. Cancellation and disconnection never acknowledge or archive feedback. Resume the original session using its saved submission cursor. Unloading this plugin withdraws its tools and skill while retaining the shared daemon and data.
+
+## Updates and distribution
+
+Update the DSH package through DSH. The webpage's one-click updater currently updates **Codex**, even if both hosts are present on the machine; it does not upgrade this DSH bundle. Preserve service home, data, port, and session IDs when updating the native service.
+
+This package targets local execution: MCP and the source workspace must be on the same machine. No remote provider, Desktop UI, model inference, or market listing is implied by a local Host test. See the repository's DeepSeek Harness guide for tested and untested paths.
+
+Publishing to npm, adding a GitHub topic, submitting to a community catalog, and showing up in a chosen Discover index are separate actions. No DeepSeek model-account login is required to load this plugin or connect its local MCP.
+
+This package uses the MIT license included in `LICENSE`. Native ZIPs retain their third-party notices. The release workflow prepares the tgz, its SHA-256 file, and the five native ZIPs together; npm publication and market submissions remain separate actions.
+
+## 中文
+
+适配 DSH `0.2.2-rc.1`：加载后启动或复用 Go 后台，接入官方 MCP Client，并注册 `logic-margin` 技能。安装生成的 tgz 后，在实际使用的 profile 重载并核对技能与工具；不要运行 Codex 专用 `server setup`。
+
+等待预算为单次 24 小时；取消不领取、不归档。卸载仅撤销本插件的连接和技能，不停止共享服务。更新 DSH 包使用宿主安装器，网页一键更新当前只更新 Codex。会话数据独立保存，保持原 home、端口和 session ID。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: logic-margin
+      name: ./index.js

package/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="96" height="96" viewBox="0 0 96 96" fill="none" role="img" aria-labelledby="title description">
+  <title id="title">LogicMargin</title>
+  <desc id="description">流程节点连接到右侧的批注气泡，代表在具体逻辑旁留下评审意见。</desc>
+  <style>
+    :root { --mark: #2563eb; }
+    @media (prefers-color-scheme: dark) { :root { --mark: #99baff; } }
+    .mark { stroke: var(--mark); stroke-width: 6; stroke-linecap: round; stroke-linejoin: round; }
+  </style>
+  <g class="mark">
+    <path d="M20 31v34m7 7h38M27 24h11" />
+    <circle cx="20" cy="24" r="7" />
+    <circle cx="20" cy="72" r="7" />
+    <circle cx="72" cy="72" r="7" />
+    <path d="M46 12h32a8 8 0 0 1 8 8v18a8 8 0 0 1-8 8H61L48 57V46h-2a8 8 0 0 1-8-8V20a8 8 0 0 1 8-8Z" />
+    <path d="M52 25h20M52 35h12" />
+  </g>
+</svg>

package/index.js

@@ -0,0 +1,29 @@
+import { fileURLToPath } from 'node:url'
+import z from '@deepseek-ai/schemastery'
+import * as McpClient from '@deepseek-ai/dsh-mcp-client'
+import * as SkillFilesystem from '@deepseek-ai/dsh-skill-filesystem'
+import { scrubbedParentEnv } from '@deepseek-ai/dsh-subprocess'
+import { startNativeServer } from './native.js'
+
+export const name = 'logic-margin'
+export const inject = ['tools', 'skills']
+export const Config = z.object({
+  home: z.string().description('Optional absolute LogicMargin service home; omit to reuse the normal shared service.'),
+  port: z.number().step(1).min(0).max(65535).description('Optional local service port; 0 selects an available port for an isolated service.'),
+})
+
+export async function apply(ctx, config = {}) {
+  const startup = new AbortController()
+  ctx.effect(() => () => startup.abort(new Error('LogicMargin plugin unloaded')))
+  const resources = fileURLToPath(new URL('./resources/logic-margin/', import.meta.url))
+  const { mcpUrl } = await startNativeServer(resources, config, startup.signal, scrubbedParentEnv())
+  await ctx.plugin(McpClient, {
+    serverName: 'logic_margin', transport: 'streamable-http', url: mcpUrl,
+    toolCallTimeoutMs: 86_400_000, failOnStartupError: true,
+  })
+  await ctx.plugin(SkillFilesystem, {
+    providerName: 'logic-margin-bundled', includeDefaultRoots: false,
+    bundledSkillDir: fileURLToPath(new URL('./resources/logic-margin/skills/', import.meta.url)), watch: false,
+  })
+  // The daemon is shared with other hosts; unloading this plugin only withdraws its MCP and skill.
+}

package/locale/en.json

@@ -0,0 +1 @@
+{"meta":{"title":"LogicMargin","description":"Review source-backed logic diagrams and saved code diffs; keep human feedback across revisions."}}

package/locale/zh.json

@@ -0,0 +1 @@
+{"meta":{"title":"LogicMargin · 逻辑旁批","description":"在有源码依据的流程图和代码差异中审查逻辑，保留批注、回复与修订历史。"}}

package/native.js

@@ -0,0 +1,91 @@
+import { execFile, spawn } from 'node:child_process'
+import { isAbsolute, join } from 'node:path'
+import { promisify } from 'node:util'
+
+const run = promisify(execFile)
+
+async function settleStartup(child, closed) {
+  const signal = kind => {
+    try {
+      if (process.platform !== 'win32' && child.pid) process.kill(-child.pid, kind)
+      else child.kill(kind)
+    } catch (error) { if (error.code !== 'ESRCH') throw error }
+  }
+  const wait = async () => {
+    let timer
+    try { return await Promise.race([closed.then(() => true), new Promise(resolve => { timer = setTimeout(() => resolve(false), 1000) })]) }
+    finally { clearTimeout(timer) }
+  }
+  signal('SIGTERM')
+  const exited = await wait()
+  if (process.platform === 'win32' && child.pid) {
+    if (!exited) await run('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { timeout: 1000, windowsHide: true }).catch(() => {})
+  } else signal('SIGKILL')
+  if (!await wait()) {
+    child.stdout?.destroy()
+    child.stderr?.destroy()
+    child.unref()
+  }
+}
+
+export function launcherCommand(resources, platform = process.platform) {
+  const scripts = join(resources, 'skills/logic-margin/scripts')
+  if (platform === 'win32') return ['powershell.exe', ['-NoLogo', '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', join(scripts, 'logic-margin.ps1')]]
+  if (platform === 'darwin' || platform === 'linux') return ['/bin/sh', [join(scripts, 'logic-margin.sh')]]
+  throw new Error(`Unsupported LogicMargin platform: ${platform}`)
+}
+
+export function validateServer(value) {
+  if (!value || value.managed !== true || typeof value.url !== 'string' || typeof value.mcpUrl !== 'string') throw new Error('LogicMargin startup did not confirm a managed local service')
+  let url, base
+  try { url = new URL(value.mcpUrl); base = new URL(value.url) } catch { throw new Error('LogicMargin returned an invalid MCP URL') }
+  if (url.protocol !== 'http:' || !['127.0.0.1', '[::1]', 'localhost'].includes(url.hostname)
+    || url.username || url.password || url.pathname !== '/mcp' || url.search || url.hash
+    || base.origin !== url.origin || base.username || base.password || base.pathname !== '/' || base.search || base.hash) throw new Error('LogicMargin MCP must use a local HTTP endpoint')
+  return { url: url.origin, mcpUrl: url.href }
+}
+
+export async function startNativeServer(resources, config, signal, parentEnv) {
+  signal.throwIfAborted()
+  if (config.home !== undefined && (typeof config.home !== 'string' || !isAbsolute(config.home))) throw new Error('LogicMargin home must be an absolute path')
+  if (config.port !== undefined && (!Number.isInteger(config.port) || config.port < 0 || config.port > 65535)) throw new Error('LogicMargin port must be an integer from 0 to 65535')
+  const [command, args] = launcherCommand(resources)
+  const env = { ...parentEnv }
+  if (config.home !== undefined) env.LOGIC_MARGIN_HOME = config.home
+  let stdout
+  // execFile does not forward detached; spawn gives the launcher its own POSIX process group.
+  const child = spawn(command, [...args, 'server', 'start', ...(config.port === undefined ? [] : ['--port', String(config.port)])], {
+    cwd: resources, env, windowsHide: true, detached: process.platform !== 'win32', stdio: ['ignore', 'pipe', 'pipe'],
+  })
+  let didClose = false
+  const closed = new Promise(resolve => child.once('close', () => { didClose = true; resolve() }))
+  let timer, abort
+  try {
+    stdout = await new Promise((resolve, reject) => {
+      const chunks = []
+      let size = 0
+      child.stdout.on('data', chunk => {
+        size += chunk.length
+        if (size > 1024 * 1024) reject(new Error('LogicMargin startup output exceeded its limit'))
+        else chunks.push(chunk)
+      })
+      child.stderr.resume()
+      child.once('error', reject)
+      child.once('close', code => code === 0 ? resolve(Buffer.concat(chunks).toString('utf8')) : reject(new Error('LogicMargin startup exited unsuccessfully')))
+      timer = setTimeout(() => reject(new Error('LogicMargin startup timed out')), 300_000)
+      abort = () => reject(signal.reason)
+      signal.addEventListener('abort', abort, { once: true })
+      if (signal.aborted) abort()
+    })
+  } catch {
+    if (!didClose) await settleStartup(child, closed)
+    if (signal.aborted) throw signal.reason
+    throw new Error('LogicMargin native startup failed; run the packaged launcher with "server status" to diagnose. No Codex configuration was changed.')
+  } finally {
+    clearTimeout(timer)
+    signal.removeEventListener('abort', abort)
+  }
+  let value
+  try { value = JSON.parse(stdout) } catch { throw new Error('LogicMargin startup returned invalid JSON') }
+  return validateServer(value)
+}

package/package.json

@@ -1,6 +1,21 @@
 {
   "name": "dsh-plugin-logicmargin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.9.18",
+  "type": "module",
+  "description": "Source-backed logic reviews with diagrams, saved code diffs, and resumable human feedback.",
+  "license": "MIT",
+  "engines": { "node": ">=24.9.0", "dsh": "0.2.2-rc.1" },
+  "keywords": ["dsh-plugin", "deepseek-harness", "logicmargin", "code-review", "mcp"],
+  "repository": { "type": "git", "url": "https://github.com/SunneeYang/LogicMargin.git", "directory": "plugins/deepseek-harness" },
+  "homepage": "https://github.com/SunneeYang/LogicMargin",
+  "exports": { ".": "./index.js", "./package.json": "./package.json", "./locale/*.json": "./locale/*.json", "./icon": "./icon.svg" },
+  "files": ["index.js", "native.js", "cordis.patch.yml", "locale", "icon.svg", "resources", "README.md", "LICENSE"],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.1.0",
+    "@deepseek-ai/schemastery": "~3.19.0",
+    "@deepseek-ai/dsh-mcp-client": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-skill-filesystem": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-subprocess": "0.2.2-rc.1"
+  },
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
+}