@deepseek-insight/dsi 0.6.8 → 0.6.9

package/build/client/_app/version.json

@@ -1 +1 @@
-{"version":"1791201535377"}
+{"version":"1791287547811"}

package/build/handler.js

@@ -2,9 +2,9 @@ import './shims.js';
 import 'node:fs';
 import 'node:path';
 import 'node:process';
-export { h as handler } from './server/chunks/handler-B_uG0xBL.js';
-import './server/chunks/index.js-CFMhxqkR.js';
-import './server/chunks/manifest.js-rflC1wxY.js';
+export { h as handler } from './server/chunks/handler-DimUSmTW.js';
+import './server/chunks/index.js-BQUp4Xgn.js';
+import './server/chunks/manifest.js-BWy6zgHL.js';
 import './env.js';
 import 'node:buffer';
 import 'node:crypto';
@@ -16,7 +16,7 @@ import './server/chunks/chunks/shared.js-HQ0rfhm4.js';
 import './server/chunks/chunks/uneval.js-BJ9Qq2SF.js';
 import './server/chunks/chunks/utils.js-CAdNO8Tu.js';
 import 'node:url';
-import './server/chunks/chunks/internal.js-DrVZK6tf.js';
+import './server/chunks/chunks/internal.js-BnJXHc1S.js';
 import './server/chunks/chunks/server.js-11-pxAWV.js';
 import './server/chunks/chunks/internal2.js-BcS47nI-.js';
 import './server/chunks/chunks/exports.js-DH_tjtdv.js';

package/build/index.js

@@ -1,7 +1,7 @@
 import http from 'node:http';
 import fs__default from 'node:fs';
 import process from 'node:process';
-import { p as polka, h as handler, f as format_listening_address } from './server/chunks/handler-B_uG0xBL.js';
+import { p as polka, h as handler, f as format_listening_address } from './server/chunks/handler-DimUSmTW.js';
 import { env, timeout_env } from './env.js';
 import { rm } from 'node:fs/promises';
 import './shims.js';
@@ -14,12 +14,12 @@ import 'node:stream';
 import './server/chunks/chunks/shared.js-HQ0rfhm4.js';
 import './server/chunks/chunks/uneval.js-BJ9Qq2SF.js';
 import './server/chunks/chunks/utils.js-CAdNO8Tu.js';
-import './server/chunks/index.js-CFMhxqkR.js';
-import './server/chunks/chunks/internal.js-DrVZK6tf.js';
+import './server/chunks/index.js-BQUp4Xgn.js';
+import './server/chunks/chunks/internal.js-BnJXHc1S.js';
 import './server/chunks/chunks/server.js-11-pxAWV.js';
 import './server/chunks/chunks/internal2.js-BcS47nI-.js';
 import './server/chunks/chunks/exports.js-DH_tjtdv.js';
-import './server/chunks/manifest.js-rflC1wxY.js';
+import './server/chunks/manifest.js-BWy6zgHL.js';
 import 'node:url';
 
 const path = env('SOCKET_PATH', false);

package/build/server/chunks/chunks/{internal.js-DrVZK6tf.js → internal.js-BnJXHc1S.js}

@@ -722,7 +722,7 @@ var options = {
 		app: ({ head, body, assets, nonce, env }) => "<!doctype html>\n<html lang=\"%paraglide.locale%\">\n	<head>\n		<meta charset=\"utf-8\" />\n		<link rel=\"icon\" href=\"" + assets + "/favicon.svg\" />\n		<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n		" + head + "\n	</head>\n	<body data-sveltekit-preload-data=\"tap\">\n		<div style=\"display: contents\">" + body + "</div>\n	</body>\n</html>\n",
 		error: error_template_default
 	},
-	version_hash: "nn29yw"
+	version_hash: "13mzflk"
 };
 async function get_hooks() {
 	let handle;
@@ -745,4 +745,4 @@ async function get_hooks() {
 }
 
 export { __commonJSMin as _, set_public_env as a, set_read_implementation as b, onDestroy as c, __exportAll as d, get_hooks as g, index_server_exports as i, options as o, public_env as p, read_implementation as r, set_private_env as s };
-//# sourceMappingURL=internal.js-DrVZK6tf.js.map
+//# sourceMappingURL=internal.js-BnJXHc1S.js.map

package/build/server/chunks/chunks/{state.js-C_zC7v8L.js → state.js-CAjHzrRZ.js}

@@ -1,4 +1,4 @@
-import { i as index_server_exports } from './internal.js-DrVZK6tf.js';
+import { i as index_server_exports } from './internal.js-BnJXHc1S.js';
 import './shared.js-HQ0rfhm4.js';
 import './exports.js-DH_tjtdv.js';
 import { U as snapshot, J as getContext, G as noop } from './server.js-11-pxAWV.js';
@@ -303,4 +303,4 @@ var page = {
 };
 
 export { afterNavigate as a, backtoworkspace2 as b, replaceState as c, dshunreachable1 as d, currentLocale as e, page as p, reapednote1 as r, sessionnotfound2 as s, t, unexpectederror1 as u };
-//# sourceMappingURL=state.js-C_zC7v8L.js.map
+//# sourceMappingURL=state.js-CAjHzrRZ.js.map

package/build/server/chunks/entries/pages/{_error.svelte.js-BLQNkziv.js → _error.svelte.js-BXeIuPj-.js}

@@ -1,7 +1,7 @@
 import { V as head, W as escape_html, y as derived } from '../../chunks/server.js-11-pxAWV.js';
-import { t, p as page, s as sessionnotfound2, r as reapednote1, d as dshunreachable1, u as unexpectederror1, b as backtoworkspace2 } from '../../chunks/state.js-C_zC7v8L.js';
+import { t, p as page, s as sessionnotfound2, r as reapednote1, d as dshunreachable1, u as unexpectederror1, b as backtoworkspace2 } from '../../chunks/state.js-CAjHzrRZ.js';
 import '../../chunks/uneval.js-BJ9Qq2SF.js';
-import '../../chunks/internal.js-DrVZK6tf.js';
+import '../../chunks/internal.js-BnJXHc1S.js';
 import '../../chunks/shared.js-HQ0rfhm4.js';
 import '../../chunks/exports.js-DH_tjtdv.js';
 import '../../chunks/config.js-B0w1-uCA.js';
@@ -40,4 +40,4 @@ function _error($$renderer, $$props) {
 }
 
 export { _error as default };
-//# sourceMappingURL=_error.svelte.js-BLQNkziv.js.map
+//# sourceMappingURL=_error.svelte.js-BXeIuPj-.js.map

package/build/server/chunks/entries/pages/{_page.svelte.js-U6RBvo4b.js → _page.svelte.js-CW-EdJ00.js}

@@ -1,4 +1,4 @@
-import { c as onDestroy, d as __exportAll } from '../../chunks/internal.js-DrVZK6tf.js';
+import { c as onDestroy, d as __exportAll } from '../../chunks/internal.js-BnJXHc1S.js';
 import { V as head, y as derived, X as bind_props, W as escape_html, Y as attr, Z as attr_style, _ as attr_class, x as setContext, $ as spread_props, a0 as attributes, a1 as clsx, a2 as ensure_array_like, a3 as element, J as getContext, a4 as stringify, a5 as html, F as run, a6 as props_id } from '../../chunks/server.js-11-pxAWV.js';
 import { U as UI_LOCALES } from '../../chunks/config.js-B0w1-uCA.js';
 import { m as mergeEntries, c as collapseSystemPromptEntries, t as truncate } from '../../chunks/dsh-events.js-D9tSYE7f.js';
@@ -7,7 +7,7 @@ import { b as applyKnobEvent, E as EMPTY_KNOBS, r as resolvePermission, l as loc
 import { D as DEFAULT_IMAGE_LIMITS } from '../../chunks/image-limits.js-CUdJ0f7r.js';
 import { a as appConfig, t as triggerMode, g as getTrigger, p as previewSegments, i as isValidTagWord, b as textPreviewOf, s as searchKey, c as shouldRecordPrompt, d as parseTagWords } from '../../chunks/app-config.svelte.js-BW7TwbBy.js';
 import { c as getLocale } from '../../chunks/runtime.js-CCJi3XaY.js';
-import { p as page, a as afterNavigate, t, c as replaceState, e as currentLocale, u as unexpectederror1, s as sessionnotfound2, r as reapednote1, d as dshunreachable1, b as backtoworkspace2 } from '../../chunks/state.js-C_zC7v8L.js';
+import { p as page, a as afterNavigate, t, c as replaceState, e as currentLocale, u as unexpectederror1, s as sessionnotfound2, r as reapednote1, d as dshunreachable1, b as backtoworkspace2 } from '../../chunks/state.js-CAjHzrRZ.js';
 import 'yaml';
 import 'html-to-image';
 import hljs from 'highlight.js/lib/core';
@@ -20999,6 +20999,23 @@ function normalizeFileLinkPath(href) {
 	return value;
 }
 /**
+* The deep fallback’s root lister: the workspace root’s top-level
+* DIRECTORY names, via the same confined tree route the existence gate
+* uses. Any refusal degrades to an empty list — the fallback then
+* silently does nothing and the honest drop stands.
+*/
+async function workspaceRootDirs(sessionId, fetchImpl = fetch) {
+	try {
+		const res = await fetchImpl(`/api/dsh/workspace-tree?sessionId=${encodeURIComponent(sessionId)}&path=`);
+		if (!res.ok) return [];
+		const body = await res.json();
+		if (body?.ok !== true || !Array.isArray(body.listing?.entries)) return [];
+		return body.listing.entries.filter((e) => e.type === "dir").map((e) => e.name);
+	} catch {
+		return [];
+	}
+}
+/**
 * Resolve a file-link path AGAINST the workspace root (Fullpath Bow ADR
 * 2026-09-26 D1): the assistant speaks in its own cwd's paths, which sit
 * one level ABOVE the workspace root, so real links carry the root path or
@@ -21052,13 +21069,21 @@ async function workspaceFileExists(sessionId, path, fetchImpl = fetch) {
 * Returns the workspace-relative path to publish, or null when both
 * candidates refuse (the click drops).
 */
-async function resolveFileLinkTarget(sessionId, path, root, exists = workspaceFileExists) {
+async function resolveFileLinkTarget(sessionId, path, root, exists = workspaceFileExists, listRoot) {
 	const resolved = resolveFileLinkPath(path, root);
 	const candidates = [resolved];
 	const slash = resolved.indexOf("/");
 	if (slash !== -1 && resolved !== path) candidates.push(resolved.slice(slash + 1));
 	if (!candidates.includes(path)) candidates.push(path);
 	for (const candidate of candidates) if (await exists(sessionId, candidate)) return candidate;
+	if (listRoot && resolved !== "" && !hasDotDotSegment(resolved)) try {
+		const dirs = await listRoot(sessionId);
+		for (const dir of dirs) {
+			if (dir === "" || dir === "." || dir === "..") continue;
+			const candidate = dir + "/" + resolved;
+			if (await exists(sessionId, candidate)) return candidate;
+		}
+	} catch {}
 	return null;
 }
 //#endregion
@@ -25220,7 +25245,7 @@ function FloatingAnchorContainerPopup($$renderer, $$props) {
 		function focus() {}
 		if (open) {
 			$$renderer.push("<!--[0-->");
-			$$renderer.push(`<div data-svelte="FloatingAnchorContainerPopup" tabindex="-1" class="pointer-events-auto absolute right-full top-1/2 z-50 mr-2 max-h-[60vh] w-max min-w-72 max-w-[80vw] -translate-y-1/2 overflow-y-auto rounded-lg border border-surface-border bg-surface-elevated py-1 shadow-xl outline-none focus:outline-none"${attr("data-testid", popupTestId)}>`);
+			$$renderer.push(`<div data-svelte="FloatingAnchorContainerPopup" tabindex="-1" class="pointer-events-auto absolute right-full top-1/2 z-50 mr-2 max-h-[60vh] w-96 max-w-[80vw] -translate-y-1/2 overflow-y-auto rounded-lg border border-surface-border bg-surface-elevated py-1 shadow-xl outline-none focus:outline-none"${attr("data-testid", popupTestId)}>`);
 			if (title !== void 0) {
 				$$renderer.push("<!--[0-->");
 				$$renderer.push(`<div class="border-b border-surface-border px-2.5 py-1.5 text-[10px] font-medium uppercase tracking-wider text-text-muted"${attr("data-testid", titleTestId)}>${escape_html(title)}</div>`);
@@ -30477,7 +30502,7 @@ function _page($$renderer, $$props) {
 		async function openFileLinkFromMarkdown(sessionId, rawHref) {
 			const { path, lines } = parseFileLinkHref(rawHref);
 			if (path === "") return;
-			const target = await resolveFileLinkTarget(sessionId, path, panelWorkspaceFor(sessionId));
+			const target = await resolveFileLinkTarget(sessionId, path, panelWorkspaceFor(sessionId), void 0, workspaceRootDirs);
 			if (target === null) return;
 			if (!sessionWorkspaceExplorer(sessionId)) {
 				const root = panelWorkspaceFor(sessionId);
@@ -31079,4 +31104,4 @@ function _page($$renderer, $$props) {
 }
 
 export { _page as default };
-//# sourceMappingURL=_page.svelte.js-U6RBvo4b.js.map
+//# sourceMappingURL=_page.svelte.js-CW-EdJ00.js.map

package/build/server/chunks/{handler-B_uG0xBL.js → handler-DimUSmTW.js}

@@ -9,8 +9,8 @@ import * as qs from 'node:querystring';
 import { Readable } from 'node:stream';
 import { S as SvelteKitError } from './chunks/shared.js-HQ0rfhm4.js';
 import './chunks/utils.js-CAdNO8Tu.js';
-import { S as Server } from './index.js-CFMhxqkR.js';
-import { m as manifest } from './manifest.js-rflC1wxY.js';
+import { S as Server } from './index.js-BQUp4Xgn.js';
+import { m as manifest } from './manifest.js-BWy6zgHL.js';
 import { env, dir, env_prefix } from '../../env.js';
 import { format } from 'node:url';
 
@@ -1732,4 +1732,4 @@ const handler = sequence(
 );
 
 export { format_listening_address as f, handler as h, polka as p };
-//# sourceMappingURL=handler-B_uG0xBL.js.map
+//# sourceMappingURL=handler-DimUSmTW.js.map

package/build/server/chunks/{index.js-CFMhxqkR.js → index.js-BQUp4Xgn.js}

@@ -1,4 +1,4 @@
-import { _ as __commonJSMin, o as options, s as set_private_env, a as set_public_env, g as get_hooks, p as public_env, r as read_implementation, b as set_read_implementation } from './chunks/internal.js-DrVZK6tf.js';
+import { _ as __commonJSMin, o as options, s as set_private_env, a as set_public_env, g as get_hooks, p as public_env, r as read_implementation, b as set_read_implementation } from './chunks/internal.js-BnJXHc1S.js';
 import { n as noop, T as TRAILING_SLASH_PARAM, I as INVALIDATED_PARAM, R as Redirect, b as get_relative_path, S as SvelteKitError, g as get_status, t as text_encoder, o as once, H as HttpError, d as normalize_error, e as create_remote_key, f as parse_remote_arg, s as stringify, h as stringify$1, A as ActionFailure, i as split_remote_key, j as base64_encode } from './chunks/shared.js-HQ0rfhm4.js';
 import { b as base, o as override, a as assets, r as reset, c as app_dir } from './chunks/internal2.js-BcS47nI-.js';
 import { f as format_server_error, j as json, i as is_form_content_type, t as text, h as has_prerendered_path, a as handle_fatal_error, r as redirect_response, g as get_set_cookies, n as negotiate, w as with_request_store, p as parseString, m as merge_tracing, b as method_not_allowed, s as static_error_page, c as handle_error_and_jsonify, d as get_global_name, e as create_replacer, k as serialize_uses, l as clarify_devalue_error, E as ENDPOINT_METHODS, P as PAGE_METHODS, o as get_node_type, q as isRedirect, u as escape_html, v as error, x as deserialize_binary_form } from './chunks/utils.js-CAdNO8Tu.js';
@@ -3861,4 +3861,4 @@ var Server = class {
 };
 
 export { Server as S };
-//# sourceMappingURL=index.js-CFMhxqkR.js.map
+//# sourceMappingURL=index.js-BQUp4Xgn.js.map

package/build/server/chunks/{manifest.js-rflC1wxY.js → manifest.js-BWy6zgHL.js}

@@ -10,11 +10,11 @@ return {
 	assets: new Set(["favicon.svg"]),
 	mimeTypes: {".svg":"image/svg+xml"},
 	_: {
-		client: {start:"_app/immutable/entry/start.B_n-sOmN.js",app:"_app/immutable/entry/app.DEAFrkJ-.js",imports:["_app/immutable/entry/start.B_n-sOmN.js","_app/immutable/chunks/ipGk-mTd.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/entry/app.DEAFrkJ-.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/HclGiUj8.js","_app/immutable/chunks/xihTtKlq.js"],stylesheets:[],fonts:[],uses_env_dynamic_public:false},
+		client: {start:"_app/immutable/entry/start.CnkkMjJa.js",app:"_app/immutable/entry/app.e7xoYywe.js",imports:["_app/immutable/entry/start.CnkkMjJa.js","_app/immutable/chunks/C1F3aCiz.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/entry/app.e7xoYywe.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/HclGiUj8.js","_app/immutable/chunks/xihTtKlq.js"],stylesheets:[],fonts:[],uses_env_dynamic_public:false},
 		nodes: [
-			__memo(() => import('./nodes/0.js-PpYt5eF3.js')),
-			__memo(() => import('./nodes/1.js-BQCqfRee.js')),
-			__memo(() => import('./nodes/2.js-Bkg7QRk0.js'))
+			__memo(() => import('./nodes/0.js-B0560RI0.js')),
+			__memo(() => import('./nodes/1.js-DJ3dsgdq.js')),
+			__memo(() => import('./nodes/2.js-CzgP_zp4.js'))
 		],
 		remotes: {
 			
@@ -445,4 +445,4 @@ return {
 })();
 
 export { manifest as m };
-//# sourceMappingURL=manifest.js-rflC1wxY.js.map
+//# sourceMappingURL=manifest.js-BWy6zgHL.js.map

package/build/server/chunks/nodes/{0.js-PpYt5eF3.js → 0.js-B0560RI0.js}

@@ -4,9 +4,9 @@ const index = 0;
 let component_cache;
 const component = async () => component_cache ??= (await import('../entries/pages/_layout.svelte.js-EFiihTdF.js')).default;
 const universal_id = "src/routes/+layout.ts";
-const imports = ["_app/immutable/nodes/0.CKr_pvH3.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/BLxS3bAX.js","_app/immutable/chunks/DlfWhx6l.js"];
-const stylesheets = ["_app/immutable/assets/0.Cz4GQ8ND.css"];
+const imports = ["_app/immutable/nodes/0.k1Ikzbp6.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/BLxS3bAX.js","_app/immutable/chunks/DlfWhx6l.js"];
+const stylesheets = ["_app/immutable/assets/0.CRU0GiZX.css"];
 const fonts = [];
 
 export { component, fonts, imports, index, stylesheets, universal_id };
-//# sourceMappingURL=0.js-PpYt5eF3.js.map
+//# sourceMappingURL=0.js-B0560RI0.js.map

package/build/server/chunks/nodes/1.js-DJ3dsgdq.js

@@ -0,0 +1,9 @@
+const index = 1;
+let component_cache;
+const component = async () => component_cache ??= (await import('../entries/pages/_error.svelte.js-BXeIuPj-.js')).default;
+const imports = ["_app/immutable/nodes/1.E4wiL8sP.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/UkmEG9Ws.js","_app/immutable/chunks/C1F3aCiz.js","_app/immutable/chunks/DlfWhx6l.js"];
+const stylesheets = [];
+const fonts = [];
+
+export { component, fonts, imports, index, stylesheets };
+//# sourceMappingURL=1.js-DJ3dsgdq.js.map

package/build/server/chunks/nodes/{2.js-Bkg7QRk0.js → 2.js-CzgP_zp4.js}

@@ -17,11 +17,11 @@ import '../chunks/uneval.js-BJ9Qq2SF.js';
 
 const index = 2;
 let component_cache;
-const component = async () => component_cache ??= (await import('../entries/pages/_page.svelte.js-U6RBvo4b.js')).default;
+const component = async () => component_cache ??= (await import('../entries/pages/_page.svelte.js-CW-EdJ00.js')).default;
 const server_id = "src/routes/+page.server.ts";
-const imports = ["_app/immutable/nodes/2.BmfcXZrQ.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/ipGk-mTd.js","_app/immutable/chunks/HclGiUj8.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/DlfWhx6l.js","_app/immutable/chunks/BLxS3bAX.js","_app/immutable/chunks/CZajmeaf.js"];
+const imports = ["_app/immutable/nodes/2.BBV-AGuB.js","_app/immutable/chunks/C-58cZAk.js","_app/immutable/chunks/C1F3aCiz.js","_app/immutable/chunks/HclGiUj8.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/DlfWhx6l.js","_app/immutable/chunks/BLxS3bAX.js","_app/immutable/chunks/UkmEG9Ws.js"];
 const stylesheets = ["_app/immutable/assets/2.BGqV97Jd.css"];
 const fonts = [];
 
 export { component, fonts, imports, index, server_id, stylesheets };
-//# sourceMappingURL=2.js-Bkg7QRk0.js.map
+//# sourceMappingURL=2.js-CzgP_zp4.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@deepseek-insight/dsi",
-	"version": "0.6.8",
+	"version": "0.6.9",
 	"description": "See your multiple agents run on the floor (agent, sub-agent, etc), each conversation on the floor are updated instantly.",
 	"keywords": [
 		"Deepseek",

package/skills/dsi-rca/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: dsi-rca
+description: Use when writing, reviewing, or marking done any RCA in deepseek-insight's dev/kb/rca/ — before drafting the first line and as the final self-audit before claiming the RCA is finished. Enforces the narrative standard the operator set after rejecting a copy-paste RCA — layman glossary, story-driven failure chains, and a mermaid flowchart AND sequence diagram are hard requirements, not style preferences.
+---
+
+# DeepSeek Insight RCA Standard
+
+An RCA that reads like release notes is a failed RCA. This skill exists
+because an agent under context rot pastes the commit message into a template
+and calls it a root-cause analysis — no story, no layman path in, no
+diagrams. The operator rejected exactly that (2026-10-06: *"paragraph seems
+like just copy paste, lack of proper narrative, not layman friendly, and
+worst do not have mermaid flow & sequence diagram"*). Everything below is
+that rejection turned into law.
+
+The exemplar that defines the bar:
+`dev/kb/rca/2026-10-06 - RCA — The Renderer That Told the Truth Badly
+(Dull Diagrams, Single-Line Tables, Captures From the Top).md` — three bugs,
+one shared root, four mermaid diagrams, and a glossary a newcomer reads
+before any code.
+
+**References (load before drafting):**
+
+- `references/rca-template.md` — the copy-verbatim skeleton, section-by-
+  section depth guide, and the single-defect variant note. **The template
+  lives there, not here; never write an RCA from memory of this page.**
+- `references/mermaid-rules.md` — diagram choice table (flowchart vs
+  sequence), the seven syntax gates that have each broken a real diagram,
+  and the accessibility/tone rules for label text.
+
+## 1. RCA or ADR or plain KB?
+
+- An **ADR** (dev/architectural-decission/, see the `dsi-adr` skill) records
+  a *decision and its cost* — what was chosen, what was rejected.
+- A **KB note** documents *how a surface works* today.
+- An **RCA** (dev/kb/rca/) reconstructs *how a defect came to exist and what
+  its existence teaches*. If your draft names no decision to revisit and no
+  defect to explain, it is not an RCA — rehome it. An RCA that ends without
+  a carry-forward lesson is a post-mortem of the code; the lesson is the
+  post-mortem of the *process*.
+
+## 2. The hard requirements (any "no" = unfinished)
+
+1. **Narrative, never paste.** Every section explains *why* in plain
+   sentences before naming a file or line. Commit messages, diff hunks, and
+   test output may be *cited*, never pasted as prose. If a paragraph could
+   stand inside a commit message, rewrite it.
+2. **Quote the operator.** Open with the defect in the operator's (or the
+   test's, or the user's) own words. The gap between those words and the
+   code is the story the RCA tells.
+3. **Layman glossary before the body.** A *Words used below* table defines
+   every term the body will use in one plain sentence each. A newcomer reads
+   the note top-to-bottom without opening the codebase.
+4. **A mermaid flowchart per failure chain.** Each bug/defect gets its own
+   `flowchart TD` tracing decision → inherited consequence → visible
+   symptom → complaint. The chain shows how a *reasonable* choice at time T
+   became a defect at time T+1 — that is the root in root-cause.
+5. **A mermaid sequenceDiagram wherever responsibility moves between
+   actors** (operator ↔ component ↔ runtime, caller ↔ clone). A flowchart
+   shows *how the state went bad*; the sequence shows *who handed it over*.
+   Choice table and syntax gates: `references/mermaid-rules.md`.
+6. **A shared-root paragraph** when the RCA covers multiple defects: one
+   paragraph naming the single underlying cause (stale defaults, an
+   inheritance chain, a missing contract) that the individual fixes merely
+   trimmed. Multi-bug RCAs without a shared root are a changelog.
+7. **"What does NOT change"** — the blast radius must be bounded in writing,
+   so the reader knows what the fix deliberately left alone.
+8. **"What to carry forward"** — dated, portable lessons (not "be careful";
+   rules like *"a clone is a photograph of a fresh document"*), each earned
+   by a specific trap in this RCA.
+9. **Fact discipline (same as the ADR skill):** every fact traces to
+   something inspected THIS session — file + line, a simulation's output, a
+   test run, a commit sha. Cite the shas.
+
+## 3. The self-audit (before claiming done)
+
+Answer each aloud, in the transcript, yes or no:
+
+1. Is every section narrative — could any paragraph be pasted into a commit
+   message? (Must be no.)
+2. Are the operator's own words quoted at the top?
+3. Would a newcomer who reads only the glossary + opening follow the story
+   without the codebase?
+4. Does EVERY failure chain have a mermaid flowchart, and does every
+   multi-actor hand-off have a sequence diagram — all parsing clean per
+   `references/mermaid-rules.md`?
+5. Does a multi-defect RCA name the shared root in one paragraph?
+6. Is "What does NOT change" present and specific?
+7. Is every carry-forward lesson a rule earned by a named trap?
+8. Does every fact carry a source inspected this session (file+line, sha,
+   simulation output)?
+9. Does the note follow the `references/rca-template.md` skeleton — all
+   headings present, all guidance deleted?
+
+Any "no" is an unfinished RCA. Fix it or shrink its claim — never declare
+done with a standing "no".
+
+## 4. Reviewing an RCA
+
+Run the same audit from outside. The three rejection reasons that matter
+most: a section that reads like a commit message; a missing or unparsable
+diagram; a carry-forward list of vibes. Style is negotiable; those three
+are not.

package/skills/dsi-rca/references/mermaid-rules.md

@@ -0,0 +1,46 @@
+# Mermaid Rules for RCAs — Syntax Gates & Diagram Choices
+
+Companion to `rca-template.md`. Same discipline as dsi-spec's
+`references/mermaid-pattern.md`: mermaid is grammar, not decoration — an
+unparsable block renders as raw text and fails the narrative contract as
+surely as a missing diagram.
+
+---
+
+## Which diagram, when
+
+| Situation | Diagram | Why |
+|---|---|---|
+| One defect's decision → consequence → symptom chain | `flowchart TD` | Shows how a reasonable choice at time T became a defect at time T+1 — the root in root-cause. |
+| Actors hand state/messages to each other (operator → component → runtime → clone) | `sequenceDiagram` | A flowchart shows how state went bad; the sequence shows WHO handed it over. |
+| Multi-defect RCA | one flowchart per defect + at least one sequence for the shared actor story | Per-defect chains stay readable; the sequence carries the shared root. |
+
+Hard floor: **every failure chain gets a flowchart; every multi-actor
+hand-off gets a sequence.** A multi-defect RCA with zero diagrams cannot
+pass the self-audit.
+
+## Syntax gates (each one has broken a real diagram)
+
+1. **No `;` in message or label text** — mermaid treats it as a statement
+   separator and silently eats the rest of the line.
+2. **`<br/>` for line breaks inside node labels** — literal newlines inside
+   `["…"]` labels are unreliable across renderers.
+3. **Single-token participant/actor names** — long names go on the `as`
+   clause: `participant Op as You (operator)`.
+4. **Every `alt`/`else`/`opt`/`loop` closes with `end`.**
+5. **Quote every node label** — `A["text (with parens)"]`; unquoted parens
+   and slashes are the classic parse error.
+6. **Edge labels are pipes with quotes**: `-->|"label text"`.
+7. **Validate before claiming done** — `mermaid.parse` in a scratch node
+   script, or the Preview tab in Zed, or DSI's own MarkdownContent preview.
+   An unparsable block is requirement-failing, cosmetic-fixable-later.
+
+## Accessibility & tone
+
+- Label text carries the *narrative* ("the reasonable decision at time T"),
+  not ids (`A`, `B`) — a diagram read aloud must still tell the story.
+- Dotted edges (`-.->`) mark dead ends and disconnected paths (the legacy
+  folder that nothing reads) — visual grammar for "not part of the live
+  chain".
+- Keep flowcharts ≤ ~8 boxes; split into per-defect diagrams rather than one
+  spaghetti graph.

package/skills/dsi-rca/references/rca-template.md

@@ -0,0 +1,88 @@
+# RCA Template — The Skeleton (copy verbatim, delete the guidance, keep the headings)
+
+The bracketed guidance in each section explains the depth that section owes.
+Guidance is scaffolding: it ships in the skill, never in the finished RCA.
+
+The exemplar that shows this template fully lived:
+`dev/kb/rca/2026-10-06 - RCA — The Renderer That Told the Truth Badly
+(Dull Diagrams, Single-Line Tables, Captures From the Top).md`.
+
+---
+
+````markdown
+# RCA — <The Name: a memorable claim about the defect, not its title>
+
+> RCA note, YYYY-MM-DD. <Two or three sentences in plain language: what
+> broke, for whom, and the shape of the cause. If multiple defects, say how
+> many and promise the shared root. Cite the fix commits by sha.>
+
+## The complaints, in the operator's own words
+<Numbered verbatim quotes of each defect report (user words, test names, or
+error text). These are the entrance of the story — never paraphrase them
+into jargon here.>
+
+## Words used below (layman glossary)
+| Word | Meaning in this note |
+|---|---|
+| **<term>** | <One plain sentence. Every jargon word the body uses lands here first.> |
+
+## The shared root, in one paragraph
+<For multi-defect RCAs: the single underlying cause the individual bugs
+share — a stale default, an inherited property, a missing contract. For a
+single-defect RCA, this section merges into the first bug's story.>
+
+## Bug 1 — <A name that states the defect as a claim>
+### The failure chain
+```mermaid
+flowchart TD
+    A["<the reasonable decision at time T>"] --> B["<the inherited consequence>"]
+    B --> C["<the visible symptom>"]
+    C --> D["<the operator-visible complaint>"]
+```
+### The fix, and the trap inside it
+<Narrative: what changed, then the secondary defect the fix itself nearly
+introduced (there almost always is one — the inheritance chain, the false
+positive, the escaped emergency net). Say how the trap was caught
+(simulation, test, preview) and why that catcher works.>
+
+<Repeat Bug N for each defect.>
+
+## <A mermaid sequenceDiagram whenever actors hand state to each other>
+<operator → component → runtime → clone; label each arrow with the actual
+call or mutation. See references/mermaid-rules.md for syntax gates.>
+
+## What does NOT change
+<Explicit blast-radius bounds: the older protections still standing, the
+modes untouched, the inputs that behave exactly as before.>
+
+## What to carry forward
+<Numbered portable lessons, each phrased as a rule with its earning trap
+attached. "Be careful" is not a lesson; "a clone is a photograph of a fresh
+document" is.>
+````
+
+---
+
+## Section-by-section depth guide
+
+- **The Name** — a claim someone remembers in six months ("The Photograph
+  That Reframed Itself"), never the component's name alone ("CanvasCopyButton
+  RCA").
+- **The complaints** — the operator's words are the entrance of the story.
+  Paraphrasing them into jargon here defeats the whole narrative contract.
+- **The glossary** — every jargon word the body will use, one plain sentence
+  each, BEFORE the body. A newcomer reads top-to-bottom without opening the
+  codebase.
+- **The shared root** — one paragraph. If you cannot write it, you have a
+  changelog, not an RCA: either find the cause the bugs share or split the
+  note.
+- **Failure chains** — the chain shows how a *reasonable* choice at time T
+  became a defect at time T+1. If your chain's first box is already a
+  mistake, you are narrating blame, not cause.
+- **The trap inside the fix** — there almost always is one (an inheritance
+  chain, a false positive, an escaped emergency net). An RCA that reports a
+  clean one-step fix is usually hiding it. Say how the trap was caught
+  (simulation, test, preview) and why that catcher works.
+- **What to carry forward** — rules with their earning trap attached.
+  "Be careful" is not a lesson; "a clone is a photograph of a fresh
+  document" is.

package/template/.dsi/resources/plugins-reff.md

@@ -1,2 +1,4 @@
 Plugins Resources:
-1. [dsh-agent-teams(*)](https://github.com/NanmiCoder/dsh-agent-teams) - [NanmiCoder](https://github.com/NanmiCoder)
+1. [superpowers-dsh](https://github.com/LayneChai/superpowers-dsh) - [LayneChai](https://github.com/LayneChai)
+2. [dsh-agent-teams(*)](https://github.com/NanmiCoder/dsh-agent-teams) - [NanmiCoder](https://github.com/NanmiCoder)
+3. [sandbase-harness](https://github.com/sandbaseai/sandbase-harness) - [sandbaseai](https://github.com/sandbaseai)

package/template/dsh-app-dev-preset/README.md

@@ -0,0 +1,69 @@
+# dsh-app-dev-preset — agent-preset bundle template
+
+A starting point for a **user agent-preset bundle** for DeepSeek Harness
+(DSH). (An *agent preset* is a recipe for one kind of agent; in DSI it appears as
+a button in the session filter row.) Copy it, rename the identity, register it on the host profile, restart.
+Full mechanics: `dev/kb/agent-presets/2026-10-06 - The Preset Bundle — Author,
+Register, Remove an Agent Preset.md`. Decision record: ADR-0015 (2026-10-06).
+
+## Files
+
+- `package.json` — bundle manifest; `dsh.bundle.patch` points the loader at
+  the patch file. Rename `name` to `@local/dsh-<my-id>-preset`.
+- `cordis.patch.yml` — inserts the preset row (`id`, `name`, `description`,
+  `order`) plus the agent-plane plugin composition (persona, tools, skills,
+  goals, plan mode, subagents, workflows, web).
+
+## 1. Copy the template
+
+```bash
+cp -R ~/agentic-ai/deepseek-insight/template/dsh-app-dev-preset ~/agentic-ai/<my-id>-preset
+```
+
+Then in the copy:
+
+1. `package.json`: set `"name": "@local/dsh-<my-id>-preset"`.
+2. `cordis.patch.yml`: change the insert row —
+   - `id: preset-<my-id>` (entry id),
+   - `config.id: <my-id>` (the preset id DSI filters on),
+   - `config.name` / `config.description` (roster copy),
+   - `config.order` (roster sort; shipped `standard`-class presets sit low).
+3. Trim or keep the `plugins:` list. **Realm rule:** any row consuming
+   `compaction` / `toolResultPruner` (or publishing a process-global
+   service) must sit inside the matching `cordis:group` with `isolate:` —
+   loose rows fail the mount audit (*The Preset That Waited*, 2026-09-12).
+
+## 2. Register on the host
+
+Edit `~/.dsh/profiles/web/package.json` and add the dependency plus its
+`link:` specifier (mirroring how `@local/dsh-app-dev-preset` is wired):
+
+```json
+"dependencies": {
+  "@local/dsh-<my-id>-preset": "link:/Users/wharsojo/agentic-ai/<my-id>-preset"
+}
+```
+
+Then:
+
+```bash
+cd ~/.dsh/profiles/web && pnpm install
+```
+
+Restart `dsh web` — the registry is populated at boot; there is no watcher.
+
+## 3. Remove
+
+1. Delete the `@local/dsh-<my-id>-preset` entries from
+   `~/.dsh/profiles/web/package.json`.
+2. `cd ~/.dsh/profiles/web && pnpm install`.
+3. Restart `dsh web`; delete the bundle directory if desired.
+
+Do **not** bother with `~/.dsh/.agent-presets/<id>/` — that legacy directory
+is not read by anything any more.
+
+## The prompt part
+
+The only prompt text in the bundle is the `persona` row's `config.prefix`
+(`{{model}}` / `{{cwd}}` resolve per session). Everything else is plugin
+composition — capability, not wording.