dsh-code-index 0.8.0 → 0.9.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-code-index",
-  "version": "0.8.0",
-  "description": "Project-aware live structural context engine for DSH agents — isolated workspace indexes, task-aware context, and fresh repo maps.",
+  "version": "0.9.1",
+  "description": "Edit-ready Context Packs for DSH agents: bounded source excerpts, changes, related tests, and inclusion evidence — local-first.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -50,7 +50,7 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0"
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -59,7 +59,7 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.4",
-    "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
     "@types/node": "^26.2.0",
     "@types/react": "^18.3.31",
     "react": "^18.3.1",

package/scripts/context-pack-demo.mjs

@@ -0,0 +1,49 @@
+// Record actual local tool calls; no model, fake card, or invented output.
+import { execFileSync } from 'node:child_process'
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
+import path from 'node:path'
+import os from 'node:os'
+import { tools } from '../dist/index.js'
+
+const root = await mkdtemp(path.join(os.tmpdir(), 'cix-demo-'))
+const git = (...args) => execFileSync('git', ['-C', root, ...args], { stdio: 'ignore' })
+const frames = []
+const started = Date.now()
+const record = text => frames.push([(Date.now() - started) / 1000, 'o', text.replace(/\n/g, '\r\n')])
+const waitUntil = async seconds => new Promise(resolve => setTimeout(resolve, Math.max(0, seconds * 1000 - (Date.now() - started))))
+try {
+  await mkdir(path.join(root, 'src')); await mkdir(path.join(root, 'tests'))
+  await writeFile(path.join(root, 'src/config.ts'), 'export function loadConfig(input: string) {\n  return input.trim()\n}\nexport function removed() { return 0 }\n')
+  await writeFile(path.join(root, 'src/startup.ts'), "import { loadConfig } from './config'\nexport function startup() { return loadConfig(' input ') }\n")
+  await writeFile(path.join(root, 'tests/config.spec.ts'), "import { loadConfig } from '../src/config'\ntest('whitespace', () => loadConfig(' input '))\n")
+  git('init', '-q'); git('config', 'user.email', 'demo@example.invalid'); git('config', 'user.name', 'Context Pack demo')
+  git('add', '.'); git('commit', '-qm', 'demo baseline')
+  const tool = tools.find(tool => tool.name === 'code_context')
+  record('dsh-code-index v0.9.0 — actual local tool calls\nClean Git repository: loadConfig, startup, related test\n')
+  await waitUntil(3)
+  record('\n> code_context({ task: "Explain loadConfig", budgetChars: 5000 })\n')
+  const first = await tool.execute({ task: 'Explain loadConfig', repoRoot: root }, {})
+  record(first + '\n')
+  await waitUntil(13)
+  record('\x1b[2J\x1b[HExternal edit: modify loadConfig, remove removed, add betaCaller\n')
+  await writeFile(path.join(root, 'src/config.ts'), "export function loadConfig(input: string) {\n  return input.toUpperCase()\n}\nexport function betaCaller() { return loadConfig('beta') }\n")
+  record('\n> code_context({ task: "Review current changes", outputFormat: "pack" })\n')
+  const pack = await tool.execute({ task: 'Review current changes', repoRoot: root, outputFormat: 'pack' }, {})
+  record(tool.output.render({}, pack).map(block => block.text ?? '').join('\n') + '\n')
+  await waitUntil(23)
+  record('\x1b[2J\x1b[H> code_context({ task: "Explain loadConfig", budgetChars: 500 })\n')
+  const bounded = await tool.execute({ task: 'Explain loadConfig', repoRoot: root, budgetChars: 500 }, {})
+  record(bounded + '\n\nActual text length: ' + bounded.length + ' / 500\n')
+  await waitUntil(30)
+  record('\nDemo complete. No publishing, model calls, or external API key.\n')
+  await mkdir(new URL('../assets/', import.meta.url), { recursive: true })
+  await writeFile(new URL('../assets/context-pack-demo.cast', import.meta.url),
+    [JSON.stringify({ version: 2, width: 110, height: 36, timestamp: Math.floor(started / 1000), title: 'Edit-ready Context Packs — real local calls' }), ...frames.map(frame => JSON.stringify(frame))].join('\n') + '\n')
+  const replay = { duration: frames.at(-1)[0], frames }
+  const html = `<!doctype html><html lang="en"><meta charset="utf-8"><title>Context Pack · 30-second local demo</title>
+<style>body{background:#10151e;color:#e2e8f0;font:15px system-ui;max-width:1000px;margin:30px auto;padding:0 20px}button{padding:8px 16px;margin-right:12px}pre{background:#19212d;padding:20px;white-space:pre-wrap;overflow:auto;height:65vh;font:13px/1.5 monospace}small{color:#a8b3c5}</style>
+<h1>Edit-ready Context Packs</h1><p>Recorded real local calls · no DSH Web Card · no model/API request</p><button id="play">Replay 30 seconds</button><span id="time"></span><pre id="terminal"></pre><small>Reproduce with node scripts/context-pack-demo.mjs after building. Output is recorded, not live.</small>
+<script>const recording=${JSON.stringify(replay).replace(/</g, '\\u003c')};let timer;function run(){clearInterval(timer);let start=performance.now(),next=0;terminal.textContent='';timer=setInterval(()=>{let elapsed=(performance.now()-start)/1000;while(next<recording.frames.length&&recording.frames[next][0]<=elapsed){let text=recording.frames[next++][2];if(text.includes('\\x1b[2J\\x1b[H')){terminal.textContent='';text=text.replace('\\x1b[2J\\x1b[H','')}terminal.textContent+=text;terminal.scrollTop=terminal.scrollHeight}time.textContent=Math.min(30,elapsed).toFixed(1)+' / 30 s';if(next===recording.frames.length)clearInterval(timer)},100)}play.onclick=run;run();</script></html>`
+  await writeFile(new URL('../assets/context-pack-demo.html', import.meta.url), html)
+  console.log(`Recorded ${replay.duration.toFixed(1)}s demo; text ${bounded.length}/500; pack ${JSON.stringify(pack).length}/5000.`)
+} finally { await rm(root, { recursive: true, force: true }) }

package/scripts/process-desktop-demo.py

@@ -0,0 +1,88 @@
+"""Cut actual DSH screen footage; never generate or replace UI content.
+
+Usage: python scripts/process-desktop-demo.py FFMPEG RAW_MP4 EDIT_JSON
+EDIT_JSON: {"segments": [{"start": 0, "duration": 5}, ...]}
+Segments must be chronological and within the original recording.
+"""
+import hashlib
+import json
+from pathlib import Path
+import subprocess
+import sys
+
+
+def sha256(path):
+    return hashlib.file_digest(path.open("rb"), "sha256").hexdigest()
+
+
+def main():
+    ffmpeg, raw, edit_path = sys.argv[1:]
+    raw, edit_path = Path(raw), Path(edit_path)
+    edit = json.loads(edit_path.read_text(encoding="utf-8"))
+    segments = edit["segments"]
+    duration = sum(s["duration"] for s in segments)
+    assert 30 <= duration <= 60, duration
+    end = 0
+    for s in segments:
+        assert s["start"] >= end and s["duration"] > 0
+        end = s["start"] + s["duration"]
+    root = Path(__file__).resolve().parents[1]
+    assets = root / "assets"
+    video = assets / "desktop-agent-v090.mp4"
+    gif = assets / "desktop-agent-v090.gif"
+    poster = assets / "desktop-agent-v090.png"
+    filters = []
+    for i, s in enumerate(segments):
+        filters.append(
+            f"[0:v]trim=start={s['start']}:duration={s['duration']},"
+            f"setpts=PTS-STARTPTS[v{i}]"
+        )
+    inputs = "".join(f"[v{i}]" for i in range(len(segments)))
+    filters.append(
+        f"{inputs}concat=n={len(segments)}:v=1:a=0,"
+        "scale=1280:-2:flags=lanczos,setsar=1,fps=15[out]"
+    )
+    subprocess.run([
+        ffmpeg, "-hide_banner", "-loglevel", "error", "-y", "-i", str(raw), "-filter_complex", ";".join(filters),
+        "-map", "[out]", "-an", "-c:v", "libx264", "-crf", "20",
+        "-preset", "medium", "-pix_fmt", "yuv420p", "-movflags", "+faststart",
+        "-map_metadata", "-1", str(video),
+    ], check=True)
+    subprocess.run([
+        ffmpeg, "-hide_banner", "-loglevel", "error", "-y", "-i", str(video), "-vf",
+        "fps=2,split[a][b];[a]palettegen=stats_mode=diff[p];"
+        "[b][p]paletteuse=dither=bayer:bayer_scale=5", "-loop", "0", str(gif),
+    ], check=True)
+    subprocess.run([
+        ffmpeg, "-hide_banner", "-loglevel", "error", "-y", "-ss", str(edit.get("posterAt", 12)), "-i", str(video),
+        "-frames:v", "1", "-update", "1", str(poster),
+    ], check=True)
+    manifest = {
+        "method": "Actual DSH Desktop screen recording; Agent task submitted through UI",
+        "recordedDate": "2026-10-08",
+        "pluginVersion": "0.9.0 (visible installed/running in Desktop UI)",
+        "rawSha256": sha256(raw),
+        "durationSeconds": duration,
+        "segments": segments,
+        "posterAt": edit.get("posterAt", 12),
+        "edits": [
+            "Chronological cuts remove setup, waiting and redundant holds",
+            "No UI, tool output or Agent response generated or replaced",
+            "Silent video resized to 1280 pixels wide, 15 fps; GIF sampled at 2 fps",
+            "Elapsed wall time is not represented by edited playback duration",
+        ],
+        "captureOperation": "User started/stopped Windows Snipping Tool; assistant operated DSH",
+        "toolResult": {"usedChars": 2347, "budgetChars": 5000},
+        "outputs": {
+            p.name: {"sha256": sha256(p), "bytes": p.stat().st_size}
+            for p in [video, gif, poster]
+        },
+    }
+    (assets / "desktop-agent-v090.provenance.json").write_bytes(
+        (json.dumps(manifest, ensure_ascii=False, indent=2) + "\n").encode("utf-8")
+    )
+    print(json.dumps(manifest, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/scripts/release-smoke.mjs

@@ -1,6 +1,6 @@
 import assert from 'node:assert/strict'
 import { execFileSync } from 'node:child_process'
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs'
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
@@ -75,6 +75,7 @@ const expectedFiles = [
   'LICENSE',
   'cordis.patch.yml',
   'dist/index.js',
+  'dist/index.d.ts',
   'dist/client.js',
   'scripts/fix-wsl-links.mjs',
   'scripts/release-smoke.mjs',
@@ -94,6 +95,8 @@ try {
   assert.equal(installedPackage.exports['.'].default, './dist/index.js')
   assert.match(installedPackage.engines.node, />=22/)
   assert.equal(installedPackage.license, 'MIT')
+  const installedTools = JSON.parse(readFileSync(path.join(smokeDir, 'node_modules', '@deepseek-ai', 'dsh-tools', 'package.json'), 'utf8'))
+  assert.equal(installedTools.version, '0.2.0-rc.2', 'fresh consumers must resolve the verified matching RC')
 
   const plugin = await import(
     pathToFileURL(path.join(smokeDir, 'node_modules', packageJson.name, 'dist', 'index.js')).href,
@@ -146,8 +149,38 @@ try {
     }),
     /Task context|Primary symbols:/,
   )
+  const contextPack = await invoke('code_context', {
+    task: 'Explain buildIndex', repoRoot: root, budgetChars: 5000, outputFormat: 'pack',
+  })
+  assert.equal(contextPack.version, 1)
+  assert.ok(contextPack.items.some(item => item.kind === 'primary' && item.name === 'buildIndex'))
+  assert.ok(contextPack.items.some(item => item.code !== undefined))
+  assert.ok(JSON.stringify(contextPack).length <= 5000)
   assert.match(await invoke('code_health', { repoRoot: root }), /repo health/)
 
+  // Issue #2 must also be fixed in the installed tarball, not just TS sources.
+  const whitelistRoot = path.join(smokeDir, 'whitelist-repo')
+  for (const dir of ['.git', 'src', 'extensions/keep', 'extensions/other']) {
+    mkdirSync(path.join(whitelistRoot, dir), { recursive: true })
+  }
+  writeFileSync(path.join(whitelistRoot, '.gitignore'), '/extensions/*\n!/extensions/keep/\n!/extensions/keep/**\n')
+  writeFileSync(path.join(whitelistRoot, 'src/control.ts'), 'export function CONTROL_MARKER_fn() { return 3 }\n')
+  writeFileSync(path.join(whitelistRoot, 'extensions/keep/kept.ts'), 'export function KEPT_MARKER_fn() { return 1 }\n')
+  writeFileSync(path.join(whitelistRoot, 'extensions/other/skip.ts'), 'export function SKIPPED_fn() { return 2 }\n')
+  assert.match(await invoke('code_index', { action: 'build', repoRoot: whitelistRoot }), /files indexed: 2/)
+  const keptHits = await invoke('code_search', { query: 'KEPT_MARKER_fn', repoRoot: whitelistRoot })
+  assert.equal(keptHits[0]?.file, 'extensions/keep/kept.ts')
+  assert.deepEqual(await invoke('code_search', { query: 'SKIPPED_fn', repoRoot: whitelistRoot }), [])
+  const keptPack = await invoke('code_context', {
+    task: 'Explain KEPT_MARKER_fn', repoRoot: whitelistRoot, outputFormat: 'pack',
+  })
+  assert.ok(keptPack.items.some(item => item.name === 'KEPT_MARKER_fn' && item.code?.includes('return 1')))
+  const freshSource = path.join(whitelistRoot, 'extensions/keep/fresh.ts')
+  writeFileSync(freshSource, 'export function FRESH_MARKER_fn() { return 91 }\n')
+  assert.equal((await invoke('code_search', { query: 'FRESH_MARKER_fn', repoRoot: whitelistRoot }))[0]?.name, 'FRESH_MARKER_fn')
+  rmSync(freshSource)
+  assert.deepEqual(await invoke('code_search', { query: 'FRESH_MARKER_fn', repoRoot: whitelistRoot }), [])
+
   for (const dispose of disposers.reverse()) dispose()
 
   const compactRegistered = []

package/scripts/render-agent-demo.py

@@ -0,0 +1,87 @@
+"""Render a 42s terminal replay from audited Desktop tool records (Pillow)."""
+import hashlib
+import json
+import textwrap
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont
+
+ROOT = Path(__file__).resolve().parents[1]
+source = ROOT / 'assets/desktop-v0.9-tool-evidence.json'
+evidence = json.loads(source.read_text(encoding='utf-8'))
+runs = {r['callSeq']: r for r in evidence['runs']}
+clean, changed, small = (runs[k] for k in (47, 60, 73))
+for run in (clean, changed, small):
+    assert len(run['renderedText'].encode('utf-16-le')) // 2 == run['actualTextChars']
+    assert run['actualTextChars'] <= run['budgetChars']
+
+def block(run, prefix):
+    return next(p for p in run['renderedText'].split('\n\n') if p.startswith(prefix))
+
+def call(run):
+    args = {k: v for k, v in run['arguments'].items() if k != 'repoRoot'}
+    return 'code_context(' + json.dumps(args, ensure_ascii=False, indent=2) + ')'
+
+scenes = [
+    ('01  Task -> actual Agent tool call', '任务描述 -> 真实 Agent 工具调用',
+     call(clean) + '\n\nCaptured: 2026-10-05 | tool/call #47 -> tool/result #48\nTiny Git fixture | repoRoot omitted from display\n\nTask wording did not name loadConfig.\nThe Agent requested code_context to locate useful context.'),
+    ('02  Primary source + inclusion reason', '关键源码、准确行号和入选理由',
+     block(clean, 'primary:') + '\n\n' + clean['renderedText'].splitlines()[-1]),
+    ('03  Caller + relationship provenance', '相关调用，以及关系证据来源',
+     block(clean, 'caller:') + '\n\n' + block(clean, 'relationship: startup')),
+    ('04  Likely test + actual test source', '相关测试线索，以及测试源码',
+     block(clean, 'test:') + '\n\n' + block(clean, 'relationship: module') + '\n\nLikely tests are retrieval leads, not coverage proof.'),
+    ('05  External edit -> Git change context', '外部编辑后，查询看到 Git 变更',
+     call(changed) + '\n\n' + block(changed, 'primary: loadConfig') + '\n\n' + block(changed, 'primary: betaCaller')),
+    ('06  Deleted source + honest budget fallback', '删除项保留基线源码，小预算明确降级',
+     block(changed, 'change: removed') + '\n\n' + block(small, 'primary:') + '\n\nGaps: budget omitted some evidence\nBudget: 327 / 500 chars (trimmed low-priority context)'),
+    ('07  Context ready for the next code step', 'Agent 已获得可继续处理任务的上下文',
+     'Review guide / 展示说明（不是 Agent 回复原文）\n\nloadConfig -> startup -> tests/config.spec.ts\nSource ranges + reasons + relationship provenance\nCurrent changes: modified / added / deleted\nClean result: 1294 / 5000 chars\nChange result: 2326 / 5000 chars\n\nNo edit or test-success claim in this replay.\n此回放展示上下文获取，不宣称已修复 Bug 或测试通过。\n\nTry a task in your repo. What context did it miss?\n欢迎试用：它漏掉了什么重要上下文？'),
+]
+
+W, H = 1280, 900
+mono_path = Path('C:/Windows/Fonts/consola.ttf')
+cjk_path = Path('C:/Windows/Fonts/msyh.ttc')
+mono = ImageFont.truetype(str(mono_path), 21)
+ui = ImageFont.truetype(str(cjk_path), 23)
+small_ui = ImageFont.truetype(str(cjk_path), 18)
+title_font = ImageFont.truetype(str(mono_path), 28)
+frames = []
+for i, (title, subtitle, body) in enumerate(scenes):
+    for second in (0,):
+        im = Image.new('RGB', (W, H), '#0d1420')
+        d = ImageDraw.Draw(im)
+        d.text((34, 22), 'dsh-code-index v0.9.0 | Edit-ready Context Packs', font=title_font, fill='#f2f6fc')
+        d.text((34, 68), '真实 Agent 记录的终端回放 / Replay of real Agent logs', font=ui, fill='#5de4c7')
+        d.text((34, 107), 'Not a desktop screen recording | 非桌面录屏 | Edited pacing / 节奏经过剪辑', font=small_ui, fill='#a6b4ca')
+        d.rounded_rectangle((24, 151, W-24, H-71), radius=12, fill='#172235', outline='#33445e')
+        d.text((44, 169), title, font=title_font, fill='#86c5ff')
+        d.text((44, 211), subtitle, font=ui, fill='#e4ecf7')
+        y = 265
+        display_lines = [part for line in body.splitlines() for part in (textwrap.wrap(line, width=94, break_long_words=False, break_on_hyphens=False) or [''])]
+        for line in display_lines:
+            font = ui if any(ord(c) > 0x3000 for c in line) else mono
+            assert d.textlength(line, font=font) < W-88, f'Line too wide: {line}'
+            assert y + 28 < H-77, f'Scene {i+1} too tall'
+            color = '#5de4c7' if line.startswith(('Reason:', 'Relationship provenance:', 'Budget:', 'Change:')) else '#e4ecf7'
+            d.text((44, y), line, font=font, fill=color)
+            y += 27
+        elapsed = i*6 + second
+        d.text((34, H-57), 'DSH Desktop 0.2.0-rc.2 | Evidence: 2026-10-05 | Excerpts / 原文节选', font=small_ui, fill='#a6b4ca')
+        d.text((1090, H-57), f'{elapsed:02d} / 42 s', font=mono, fill='#a6b4ca')
+        d.rectangle((0, H-8, int(W*(elapsed+1)/42), H), fill='#5de4c7')
+        frames.append(im)
+
+assets = ROOT / 'assets'
+frames[1].save(assets / 'agent-context-demo.png')
+frames[0].save(assets / 'agent-context-demo.gif', save_all=True, append_images=frames[1:], duration=6000, loop=0, optimize=True)
+preview_dir = ROOT / '.promotion-work/demo-frames'
+preview_dir.mkdir(parents=True, exist_ok=True)
+for i in range(7):
+    frames[i].save(preview_dir / f'{i+1}.png')
+cast_frames = [[i*6, 'o', '\x1b[2J\x1b[H' + title + '\r\n' + subtitle + '\r\n\r\n' + body.replace('\n', '\r\n')] for i, (title, subtitle, body) in enumerate(scenes)]
+cast_frames.append([42, 'o', '\r\nReplay complete / 回放结束\r\n'])
+header = {'version': 2, 'width': 110, 'height': 30, 'title': 'Real Desktop Agent log replay (not screen capture)', 'duration': 42}
+(assets / 'agent-context-demo.cast').write_bytes(('\n'.join(json.dumps(x, ensure_ascii=False) for x in [header, *cast_frames]) + '\n').encode('utf-8'))
+manifest = {'format': 'Terminal-style replay of actual persisted Agent records; not a screen capture', 'durationSeconds': 42, 'source': source.name, 'sourceSha256': hashlib.sha256(source.read_bytes()).hexdigest(), 'callSeqs': [47, 60, 73], 'edits': ['7 panels with 6-second holds; timing is editorial, not measured latency', 'repoRoot omitted from displayed arguments', 'Verbatim source/reason/provenance excerpts; not all returned items shown', 'First/last panel commentary is authored narration, not Agent response'], 'sceneTitles': [s[0] for s in scenes]}
+(assets / 'agent-context-demo.provenance.json').write_bytes((json.dumps(manifest, ensure_ascii=False, indent=2) + '\n').encode('utf-8'))
+print('Rendered 42-second bilingual replay from real Desktop callSeqs 47, 60, 73.')