modkh 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (256) hide show
  1. package/README.md +24 -2
  2. package/dist/agent/bundled-skills.d.ts +13 -0
  3. package/dist/agent/bundled-skills.js +95 -0
  4. package/dist/agent/images.d.ts +10 -0
  5. package/dist/agent/images.js +33 -0
  6. package/dist/agent/loop.d.ts +56 -0
  7. package/dist/agent/loop.js +155 -0
  8. package/dist/agent/skills.d.ts +20 -0
  9. package/dist/agent/skills.js +169 -0
  10. package/dist/agent/types.d.ts +132 -0
  11. package/dist/agent/types.js +12 -0
  12. package/dist/cli/agents.d.ts +8 -0
  13. package/dist/cli/agents.js +12 -0
  14. package/dist/cli/approval.d.ts +27 -0
  15. package/dist/cli/approval.js +62 -0
  16. package/dist/cli/catalog.d.ts +39 -0
  17. package/dist/cli/catalog.js +76 -0
  18. package/dist/cli/chat.d.ts +18 -0
  19. package/dist/cli/chat.js +733 -0
  20. package/dist/cli/clipboard.d.ts +9 -0
  21. package/dist/cli/clipboard.js +54 -0
  22. package/dist/cli/color.d.ts +42 -0
  23. package/dist/cli/color.js +176 -0
  24. package/dist/cli/config.d.ts +41 -0
  25. package/dist/cli/config.js +188 -0
  26. package/dist/cli/editor.d.ts +16 -0
  27. package/dist/cli/editor.js +77 -0
  28. package/dist/cli/keys.d.ts +18 -0
  29. package/dist/cli/keys.js +82 -0
  30. package/dist/cli/language.d.ts +1 -0
  31. package/dist/cli/language.js +105 -0
  32. package/dist/cli/limits.d.ts +13 -0
  33. package/dist/cli/limits.js +19 -0
  34. package/dist/cli/lines.d.ts +18 -0
  35. package/dist/cli/lines.js +80 -0
  36. package/dist/cli/models.d.ts +4 -0
  37. package/dist/cli/models.js +69 -0
  38. package/dist/cli/permissions.d.ts +25 -0
  39. package/dist/cli/permissions.js +30 -0
  40. package/dist/cli/plugins.d.ts +1 -0
  41. package/dist/cli/plugins.js +53 -0
  42. package/dist/cli/providers.d.ts +46 -0
  43. package/dist/cli/providers.js +76 -0
  44. package/dist/cli/terminal.d.ts +143 -0
  45. package/dist/cli/terminal.js +742 -0
  46. package/dist/cli/usage.d.ts +29 -0
  47. package/dist/cli/usage.js +75 -0
  48. package/dist/index.d.ts +11 -0
  49. package/dist/index.js +164 -0
  50. package/dist/language/catalog.d.ts +44 -0
  51. package/dist/language/catalog.js +100 -0
  52. package/dist/language/commonlisp-bundled.d.ts +11 -0
  53. package/dist/language/commonlisp-bundled.js +22 -0
  54. package/dist/language/commonlisp-dependencies.d.ts +16 -0
  55. package/dist/language/commonlisp-dependencies.js +68 -0
  56. package/dist/language/commonlisp-install.d.ts +14 -0
  57. package/dist/language/commonlisp-install.js +213 -0
  58. package/dist/language/commonlisp-reader.d.ts +17 -0
  59. package/dist/language/commonlisp-reader.js +47 -0
  60. package/dist/language/commonlisp-systems.d.ts +3 -0
  61. package/dist/language/commonlisp-systems.js +32 -0
  62. package/dist/language/commonlisp-tls.d.ts +10 -0
  63. package/dist/language/commonlisp-tls.js +51 -0
  64. package/dist/language/detect.d.ts +29 -0
  65. package/dist/language/detect.js +103 -0
  66. package/dist/language/grammars/LICENSE +24 -0
  67. package/dist/language/grammars/manifest.json +76 -0
  68. package/dist/language/grammars/tree-sitter-c.wasm +0 -0
  69. package/dist/language/grammars/tree-sitter-cpp.wasm +0 -0
  70. package/dist/language/grammars/tree-sitter-css.wasm +0 -0
  71. package/dist/language/grammars/tree-sitter-html.wasm +0 -0
  72. package/dist/language/grammars/tree-sitter-javascript.wasm +0 -0
  73. package/dist/language/grammars/tree-sitter-php.wasm +0 -0
  74. package/dist/language/grammars/tree-sitter-python.wasm +0 -0
  75. package/dist/language/grammars/tree-sitter-ruby.wasm +0 -0
  76. package/dist/language/grammars/tree-sitter-rust.wasm +0 -0
  77. package/dist/language/grammars/tree-sitter-swift.wasm +0 -0
  78. package/dist/language/grammars/tree-sitter-tsx.wasm +0 -0
  79. package/dist/language/grammars/tree-sitter-typescript.wasm +0 -0
  80. package/dist/language/install.d.ts +50 -0
  81. package/dist/language/install.js +293 -0
  82. package/dist/language/lsp/client.d.ts +97 -0
  83. package/dist/language/lsp/client.js +337 -0
  84. package/dist/language/lsp/pool.d.ts +67 -0
  85. package/dist/language/lsp/pool.js +122 -0
  86. package/dist/language/lsp/service.d.ts +46 -0
  87. package/dist/language/lsp/service.js +138 -0
  88. package/dist/language/native.d.ts +8 -0
  89. package/dist/language/native.js +100 -0
  90. package/dist/language/platform.d.ts +14 -0
  91. package/dist/language/platform.js +20 -0
  92. package/dist/language/positions.d.ts +20 -0
  93. package/dist/language/positions.js +46 -0
  94. package/dist/language/syntax/assets.d.ts +9 -0
  95. package/dist/language/syntax/assets.js +73 -0
  96. package/dist/language/syntax/parser.d.ts +24 -0
  97. package/dist/language/syntax/parser.js +144 -0
  98. package/dist/language/typescript-capability.d.ts +6 -0
  99. package/dist/language/typescript-capability.js +42 -0
  100. package/dist/lisp/config.d.ts +16 -0
  101. package/dist/lisp/config.js +159 -0
  102. package/dist/lisp/routing.d.ts +5 -0
  103. package/dist/lisp/routing.js +24 -0
  104. package/dist/lisp/runtime.d.ts +21 -0
  105. package/dist/lisp/runtime.js +83 -0
  106. package/dist/memory/kiokuko.d.ts +32 -0
  107. package/dist/memory/kiokuko.js +102 -0
  108. package/dist/memory/mcp.d.ts +38 -0
  109. package/dist/memory/mcp.js +211 -0
  110. package/dist/model/ai-sdk.d.ts +27 -0
  111. package/dist/model/ai-sdk.js +180 -0
  112. package/dist/model/chatgpt/login.d.ts +42 -0
  113. package/dist/model/chatgpt/login.js +180 -0
  114. package/dist/model/chatgpt/responses.d.ts +41 -0
  115. package/dist/model/chatgpt/responses.js +202 -0
  116. package/dist/model/chatgpt/tokens.d.ts +11 -0
  117. package/dist/model/chatgpt/tokens.js +50 -0
  118. package/dist/model/connection.d.ts +6 -0
  119. package/dist/model/connection.js +65 -0
  120. package/dist/model/context.d.ts +9 -0
  121. package/dist/model/context.js +69 -0
  122. package/dist/model/factory.d.ts +25 -0
  123. package/dist/model/factory.js +88 -0
  124. package/dist/model/fixed.d.ts +17 -0
  125. package/dist/model/fixed.js +41 -0
  126. package/dist/model/reasoning.d.ts +16 -0
  127. package/dist/model/reasoning.js +62 -0
  128. package/dist/plugins/api.d.ts +60 -0
  129. package/dist/plugins/api.js +1 -0
  130. package/dist/plugins/manager.d.ts +34 -0
  131. package/dist/plugins/manager.js +261 -0
  132. package/dist/plugins/package.d.ts +13 -0
  133. package/dist/plugins/package.js +99 -0
  134. package/dist/plugins/registry.d.ts +8 -0
  135. package/dist/plugins/registry.js +14 -0
  136. package/dist/session/store.d.ts +82 -0
  137. package/dist/session/store.js +285 -0
  138. package/dist/session/workspace.d.ts +19 -0
  139. package/dist/session/workspace.js +73 -0
  140. package/dist/subagents/processes.d.ts +18 -0
  141. package/dist/subagents/processes.js +73 -0
  142. package/dist/subagents/request.d.ts +4 -0
  143. package/dist/subagents/request.js +21 -0
  144. package/dist/subagents/service.d.ts +39 -0
  145. package/dist/subagents/service.js +352 -0
  146. package/dist/subagents/settings.d.ts +10 -0
  147. package/dist/subagents/settings.js +32 -0
  148. package/dist/subagents/types.d.ts +43 -0
  149. package/dist/subagents/types.js +1 -0
  150. package/dist/subagents/verification.d.ts +31 -0
  151. package/dist/subagents/verification.js +178 -0
  152. package/dist/tools/diff.d.ts +6 -0
  153. package/dist/tools/diff.js +82 -0
  154. package/dist/tools/edit.d.ts +3 -0
  155. package/dist/tools/edit.js +152 -0
  156. package/dist/tools/files.d.ts +6 -0
  157. package/dist/tools/files.js +96 -0
  158. package/dist/tools/formal.d.ts +8 -0
  159. package/dist/tools/formal.js +77 -0
  160. package/dist/tools/guard.d.ts +7 -0
  161. package/dist/tools/guard.js +48 -0
  162. package/dist/tools/job-tools.d.ts +19 -0
  163. package/dist/tools/job-tools.js +148 -0
  164. package/dist/tools/jobs.d.ts +77 -0
  165. package/dist/tools/jobs.js +181 -0
  166. package/dist/tools/language.d.ts +6 -0
  167. package/dist/tools/language.js +174 -0
  168. package/dist/tools/registry.d.ts +28 -0
  169. package/dist/tools/registry.js +105 -0
  170. package/dist/tools/run.d.ts +13 -0
  171. package/dist/tools/run.js +159 -0
  172. package/dist/tools/search.d.ts +2 -0
  173. package/dist/tools/search.js +156 -0
  174. package/dist/tools/shell-process.d.ts +115 -0
  175. package/dist/tools/shell-process.js +286 -0
  176. package/dist/tools/skills.d.ts +2 -0
  177. package/dist/tools/skills.js +46 -0
  178. package/dist/tools/web.d.ts +24 -0
  179. package/dist/tools/web.js +386 -0
  180. package/docs/ci-repair-20261116.md +30 -0
  181. package/docs/commonlisp-provider-migration.md +22 -0
  182. package/docs/commonlisp-qlot-recovery.md +28 -0
  183. package/docs/commonlisp-tls-recovery.md +28 -0
  184. package/docs/context-efficiency.md +100 -0
  185. package/docs/input.md +66 -0
  186. package/docs/languages.md +117 -0
  187. package/docs/models.md +85 -0
  188. package/docs/modkh-evidence.json +641 -0
  189. package/docs/modkh-failure-comparison.json +675 -0
  190. package/docs/modkh-namespace.md +39 -0
  191. package/docs/modkh-qlot-evidence.json +37 -0
  192. package/docs/modkh-verification.md +173 -0
  193. package/docs/modkh.md +124 -0
  194. package/docs/presets.md +19 -0
  195. package/docs/setup.md +112 -0
  196. package/docs/subagents.md +134 -0
  197. package/docs/web.md +57 -0
  198. package/experiments/presets/common-lisp.lisp +38 -0
  199. package/experiments/presets/css.lisp +38 -0
  200. package/experiments/presets/formal.lisp +7 -0
  201. package/experiments/presets/html.lisp +38 -0
  202. package/experiments/presets/js.lisp +38 -0
  203. package/experiments/presets/php.lisp +38 -0
  204. package/experiments/presets/svelte.lisp +38 -0
  205. package/experiments/presets/tailwindcss.lisp +24 -0
  206. package/experiments/presets/ts.lisp +38 -0
  207. package/package.json +49 -4
  208. package/plugins/modkh-explorer/index.mjs +3 -0
  209. package/plugins/modkh-explorer/plugin.json +1 -0
  210. package/plugins/modkh-worker/index.mjs +3 -0
  211. package/plugins/modkh-worker/plugin.json +1 -0
  212. package/skills/kiokuko-dsh/LICENSE +21 -0
  213. package/skills/kiokuko-dsh/coding-ideal-routine-skill/SKILL.md +106 -0
  214. package/skills/kiokuko-dsh/japanese-translation-for-oss-models/SKILL.md +65 -0
  215. package/skills/kiokuko-dsh/kiokuko-architecture/SKILL.md +20 -0
  216. package/skills/kiokuko-dsh/kiokuko-architecture/references/cases.md +11 -0
  217. package/skills/kiokuko-dsh/kiokuko-benchmark/SKILL.md +20 -0
  218. package/skills/kiokuko-dsh/kiokuko-benchmark/references/cases.md +11 -0
  219. package/skills/kiokuko-dsh/kiokuko-investigate/SKILL.md +20 -0
  220. package/skills/kiokuko-dsh/kiokuko-investigate/references/cases.md +11 -0
  221. package/skills/kiokuko-dsh/kiokuko-lisp/SKILL.md +390 -0
  222. package/skills/kiokuko-dsh/kiokuko-review/SKILL.md +20 -0
  223. package/skills/kiokuko-dsh/kiokuko-review/references/cases.md +11 -0
  224. package/skills/kiokuko-dsh/kiokuko-simple-work/SKILL.md +70 -0
  225. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/SKILL.md +79 -0
  226. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md +52 -0
  227. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/domain-and-types.md +48 -0
  228. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/effects-and-data.md +43 -0
  229. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +314 -0
  230. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/problem-shaping-and-language.md +90 -0
  231. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/protocols-and-idempotency.md +42 -0
  232. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/review-checklist.md +92 -0
  233. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/verification.md +45 -0
  234. package/skills/kiokuko-dsh/kiokuko-skill-authoring/SKILL.md +20 -0
  235. package/skills/kiokuko-dsh/kiokuko-skill-authoring/references/cases.md +11 -0
  236. package/skills/kiokuko-dsh/kiokuko-soul/SKILL.md +25 -0
  237. package/skills/kiokuko-dsh/kiokuko-technical-writing/SKILL.md +20 -0
  238. package/skills/kiokuko-dsh/kiokuko-technical-writing/references/cases.md +11 -0
  239. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/SKILL.md +64 -0
  240. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/accessibility-and-navigation.md +31 -0
  241. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/async-recovery.md +49 -0
  242. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/forms-and-controls.md +35 -0
  243. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/interaction-feedback.md +34 -0
  244. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/responsive-and-platform.md +38 -0
  245. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/safety-and-review.md +43 -0
  246. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/ui-checklist.md +75 -0
  247. package/skills/kiokuko-dsh/kiokuko-verification/SKILL.md +20 -0
  248. package/skills/kiokuko-dsh/kiokuko-verification/references/cases.md +11 -0
  249. package/skills/kiokuko-dsh/manifest.json +168 -0
  250. package/skills/kiokuko-dsh/memory-reasoning/SKILL.md +44 -0
  251. package/skills/kiokuko-dsh/one-shot-software-completion/SKILL.md +113 -0
  252. package/skills/kiokuko-dsh/one-shot-software-completion/references/boundaries-and-lifecycle.md +70 -0
  253. package/skills/kiokuko-dsh/one-shot-software-completion/references/discovery-and-scope.md +71 -0
  254. package/skills/kiokuko-dsh/one-shot-software-completion/references/failure-recovery.md +43 -0
  255. package/skills/kiokuko-dsh/one-shot-software-completion/references/verification-and-completion.md +73 -0
  256. package/skills/kiokuko-dsh/veteran-programmer-skill/SKILL.md +66 -0
@@ -0,0 +1,386 @@
1
+ import { ToolError } from "../agent/types.js";
2
+ import { resolveApiKey } from "../cli/keys.js";
3
+ /**
4
+ * 外部ネットワークへの取得。ワークスペース内に閉じない唯一の読み取り系ツールなので、
5
+ * `outsideWorkspace: true` で承認を求める。既定の `workspace` ポリシーでも `none` でも
6
+ * 毎回確認され、`all` のときだけ設定どおり自動になる(OSレベルの隔離ではない)。
7
+ *
8
+ * ここで行うのは取得だけであり、結果の真偽は保証しない。本文は上限で打ち切り、
9
+ * 打ち切ったことを必ず明示する(黙って切り詰めない)。
10
+ */
11
+ const DEFAULT_MAX_BYTES = 512 * 1024;
12
+ const MAX_BYTES_LIMIT = 2 * 1024 * 1024;
13
+ const DEFAULT_TIMEOUT_MS = 30_000;
14
+ const MAX_TIMEOUT_MS = 120_000;
15
+ const MAX_REDIRECTS = 5;
16
+ /** 抽出後の本文としてモデルへ返す上限。超えたら末尾を落として明示する。 */
17
+ const TEXT_BUDGET = 32 * 1024;
18
+ const SEARCH_TIMEOUT_MS = 20_000;
19
+ const BRAVE_ENDPOINT = 'https://api.search.brave.com/res/v1/web/search';
20
+ const BRAVE_ENV = 'BRAVE_SEARCH_API_KEY';
21
+ const BRAVE_PROVIDER = 'brave-search';
22
+ function positiveInt(value, name, max) {
23
+ if (value === undefined)
24
+ return undefined;
25
+ const n = typeof value === 'string' && /^\d+$/.test(value.trim()) ? Number(value.trim()) : typeof value === 'number' ? value : Number.NaN;
26
+ if (!Number.isSafeInteger(n) || n < 1 || n > max)
27
+ throw new ToolError('INVALID_ARGS', `${name} は1〜${max}の整数で指定する`);
28
+ return n;
29
+ }
30
+ /** http/https のみ。資格情報つきURLは承認ログに秘密が載るため拒否する。 */
31
+ function parseTarget(input) {
32
+ if (typeof input !== 'string' || input.trim().length === 0 || input.length > 4096) {
33
+ throw new ToolError('INVALID_ARGS', 'url は1〜4096文字の文字列で指定する');
34
+ }
35
+ let url;
36
+ try {
37
+ url = new URL(input.trim());
38
+ }
39
+ catch {
40
+ throw new ToolError('INVALID_ARGS', `url を解釈できない: ${input}`);
41
+ }
42
+ if (url.protocol !== 'http:' && url.protocol !== 'https:') {
43
+ throw new ToolError('INVALID_ARGS', `http/https のみ取得できる: ${url.protocol}`);
44
+ }
45
+ if (url.username || url.password) {
46
+ throw new ToolError('INVALID_ARGS', 'URLに資格情報を埋め込まない(承認の表示に秘密が載る)');
47
+ }
48
+ return url;
49
+ }
50
+ const ENTITIES = {
51
+ amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ', copy: '©', reg: '®',
52
+ hellip: '…', mdash: '—', ndash: '–', laquo: '«', raquo: '»', middot: '·',
53
+ };
54
+ function decodeEntities(text) {
55
+ return text.replace(/&(#[xX]?[0-9a-fA-F]+|[a-zA-Z]+);/g, (match, body) => {
56
+ if (body.startsWith('#')) {
57
+ const hex = body[1] === 'x' || body[1] === 'X';
58
+ const code = Number.parseInt(hex ? body.slice(2) : body.slice(1), hex ? 16 : 10);
59
+ if (!Number.isFinite(code) || code <= 0 || code > 0x10ffff)
60
+ return match;
61
+ try {
62
+ return String.fromCodePoint(code);
63
+ }
64
+ catch {
65
+ return match;
66
+ }
67
+ }
68
+ return ENTITIES[body.toLowerCase()] ?? match;
69
+ });
70
+ }
71
+ /** タグを落とし、ブロック境界だけ改行として残す。整形結果の見た目は保証しない。 */
72
+ export function htmlToText(html) {
73
+ let text = html.replace(/<!--[\s\S]*?-->/g, ' ');
74
+ text = text.replace(/<(script|style|noscript|template|svg|head)\b[\s\S]*?<\/\1\s*>/gi, ' ');
75
+ text = text.replace(/<\/(p|div|li|tr|h[1-6]|section|article|header|footer|blockquote|pre|table|ul|ol)\s*>/gi, '\n');
76
+ text = text.replace(/<br\s*\/?>/gi, '\n');
77
+ text = text.replace(/<\/t[dh]\s*>/gi, '\t');
78
+ text = text.replace(/<[^>]*>/g, '');
79
+ text = decodeEntities(text);
80
+ return text
81
+ .replace(/\r\n?/g, '\n')
82
+ .replace(/[ \t\u00a0]+/g, ' ')
83
+ .replace(/ *\n */g, '\n')
84
+ .replace(/\n{3,}/g, '\n\n')
85
+ .trim();
86
+ }
87
+ function clipText(text, budget) {
88
+ if (text.length <= budget)
89
+ return { text, clipped: 0 };
90
+ return { text: text.slice(0, budget), clipped: text.length - budget };
91
+ }
92
+ function charsetOf(contentType) {
93
+ const match = /charset\s*=\s*"?([^\s;"]+)/i.exec(contentType ?? '');
94
+ return match?.[1] ?? 'utf-8';
95
+ }
96
+ function decodeBody(bytes, contentType) {
97
+ try {
98
+ return new TextDecoder(charsetOf(contentType), { fatal: false }).decode(bytes);
99
+ }
100
+ catch {
101
+ return new TextDecoder('utf-8', { fatal: false }).decode(bytes);
102
+ }
103
+ }
104
+ function isTextual(contentType) {
105
+ if (!contentType)
106
+ return true;
107
+ const type = contentType.split(';')[0].trim().toLowerCase();
108
+ return type.startsWith('text/') || type === 'application/json' || type === 'application/xml'
109
+ || type === 'application/xhtml+xml' || type === 'application/javascript' || type.endsWith('+json') || type.endsWith('+xml');
110
+ }
111
+ function isHtml(contentType) {
112
+ const type = (contentType ?? '').split(';')[0].trim().toLowerCase();
113
+ return type === 'text/html' || type === 'application/xhtml+xml';
114
+ }
115
+ async function readBounded(body, limit) {
116
+ if (!body)
117
+ return { bytes: new Uint8Array(0), truncated: false, total: 0 };
118
+ const reader = body.getReader();
119
+ const chunks = [];
120
+ let total = 0;
121
+ let truncated = false;
122
+ try {
123
+ for (;;) {
124
+ const { done, value } = await reader.read();
125
+ if (done)
126
+ break;
127
+ if (!value)
128
+ continue;
129
+ total += value.byteLength;
130
+ if (total > limit) {
131
+ chunks.push(value.subarray(0, value.byteLength - (total - limit)));
132
+ truncated = true;
133
+ break;
134
+ }
135
+ chunks.push(value);
136
+ }
137
+ }
138
+ finally {
139
+ if (truncated)
140
+ await reader.cancel().catch(() => { });
141
+ else
142
+ reader.releaseLock();
143
+ }
144
+ const kept = Math.min(total, limit);
145
+ const joined = new Uint8Array(kept);
146
+ let offset = 0;
147
+ for (const chunk of chunks) {
148
+ if (offset >= kept)
149
+ break;
150
+ const slice = chunk.subarray(0, Math.min(chunk.byteLength, kept - offset));
151
+ joined.set(slice, offset);
152
+ offset += slice.byteLength;
153
+ }
154
+ return { bytes: joined, truncated, total };
155
+ }
156
+ function signalFor(ctx, timeoutMs) {
157
+ const timeout = AbortSignal.timeout(timeoutMs);
158
+ let timedOut = false;
159
+ timeout.addEventListener('abort', () => { timedOut = true; }, { once: true });
160
+ return {
161
+ signal: ctx.signal ? AbortSignal.any([ctx.signal, timeout]) : timeout,
162
+ timedOut: () => timedOut && !(ctx.signal?.aborted ?? false),
163
+ };
164
+ }
165
+ /** 1ホップごとに承認を取る。転送先は人間が承認したURLとは別の場所になり得るため。 */
166
+ async function approveFetch(ctx, url, step, extra) {
167
+ if (ctx.signal?.aborted)
168
+ throw new ToolError('NOT_EXECUTED', '中断済みのため取得しない');
169
+ const ok = await ctx.approval.approve({
170
+ kind: 'command',
171
+ title: `外部取得 (GET ${url.host})`,
172
+ detail: `${step}\nGET ${url.href}\n${extra}\n\n外部への通信であり、応答内容は検証されない。`,
173
+ outsideWorkspace: true,
174
+ ...(ctx.signal ? { signal: ctx.signal } : {}),
175
+ });
176
+ if (!ok)
177
+ throw new ToolError('DENIED', '承認されなかったため取得しない');
178
+ if (ctx.signal?.aborted)
179
+ throw new ToolError('NOT_EXECUTED', '中断済みのため取得しない');
180
+ }
181
+ function describeFailure(url, error, signal, timedOut, timeoutMs) {
182
+ if (signal.aborted) {
183
+ if (timedOut())
184
+ return new ToolError('TIMEOUT', `${timeoutMs}ms で応答がないため打ち切った: ${url.href}`);
185
+ // 要求は送信済みかもしれない。再送の判断は呼び出し側に持たせる。
186
+ return new ToolError('RESULT_UNKNOWN', `中断により結果不明(要求は送信済みの可能性がある): ${url.href}`);
187
+ }
188
+ const cause = error instanceof Error ? (error.cause instanceof Error ? `${error.message} (${error.cause.message})` : error.message) : String(error);
189
+ return new ToolError('FETCH_FAILED', `取得できない: ${url.href} — ${cause}`);
190
+ }
191
+ export function createFetchUrlTool(options = {}) {
192
+ const maxBytesLimit = options.maxBytes ?? MAX_BYTES_LIMIT;
193
+ const defaultTimeout = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
194
+ return {
195
+ readOnly: true,
196
+ name: 'fetch_url',
197
+ operationIdentity: (args) => ({ url: typeof args.url === 'string' ? args.url.trim() : '' }),
198
+ description: 'http/https のURLを1件取得し、テキストとして返す。ワークスペース外への通信なので毎回承認を求める。'
199
+ + 'HTMLはタグを落として本文だけにする。上限で打ち切った場合は明示する。'
200
+ + '取得結果は事実の保証ではない(内容の検証はしない)。',
201
+ parameters: {
202
+ type: 'object',
203
+ properties: {
204
+ url: { type: 'string', maxLength: 4096, description: '取得するURL(http/https)' },
205
+ maxBytes: { type: 'number', description: `本文のバイト上限(既定 ${DEFAULT_MAX_BYTES}、最大 ${MAX_BYTES_LIMIT})` },
206
+ timeoutMs: { type: 'number', description: `制限時間(ms、既定 ${DEFAULT_TIMEOUT_MS}、最大 ${MAX_TIMEOUT_MS})` },
207
+ },
208
+ required: ['url'],
209
+ },
210
+ async execute(args, ctx) {
211
+ const target = parseTarget(args.url);
212
+ const maxBytes = Math.min(positiveInt(args.maxBytes, 'maxBytes', maxBytesLimit) ?? DEFAULT_MAX_BYTES, MAX_BYTES_LIMIT);
213
+ const timeoutMs = positiveInt(args.timeoutMs, 'timeoutMs', MAX_TIMEOUT_MS) ?? defaultTimeout;
214
+ const { signal, timedOut } = signalFor(ctx, timeoutMs);
215
+ let url = target;
216
+ const hops = [];
217
+ for (let hop = 0;; hop++) {
218
+ await approveFetch(ctx, url, hop === 0 ? '外部URLの取得' : `転送 ${hop} 回目の取得先`, `本文上限 ${maxBytes} バイト / 制限時間 ${timeoutMs}ms`);
219
+ let response;
220
+ try {
221
+ response = await fetch(url, { method: 'GET', redirect: 'manual', signal, headers: { accept: 'text/html,application/json,text/plain;q=0.9,*/*;q=0.5' } });
222
+ }
223
+ catch (e) {
224
+ throw describeFailure(url, e, signal, timedOut, timeoutMs);
225
+ }
226
+ const location = response.headers.get('location');
227
+ if (response.status >= 300 && response.status < 400 && location) {
228
+ await response.body?.cancel().catch(() => { });
229
+ if (hop >= MAX_REDIRECTS) {
230
+ throw new ToolError('FETCH_FAILED', `転送が ${MAX_REDIRECTS} 回を超えたため打ち切った: ${target.href} → ${url.href}`);
231
+ }
232
+ let next;
233
+ try {
234
+ next = new URL(location, url);
235
+ }
236
+ catch {
237
+ throw new ToolError('FETCH_FAILED', `転送先のURLを解釈できない: ${location}`);
238
+ }
239
+ // 転送先も同じ規則で検証してから、改めて承認を取る。
240
+ if (next.protocol !== 'http:' && next.protocol !== 'https:') {
241
+ throw new ToolError('FETCH_FAILED', `転送先が http/https ではない: ${next.protocol}`);
242
+ }
243
+ if (next.username || next.password)
244
+ throw new ToolError('FETCH_FAILED', '転送先のURLに資格情報が含まれる');
245
+ hops.push(`${response.status} ${url.href} → ${next.href}`);
246
+ url = next;
247
+ continue;
248
+ }
249
+ let read;
250
+ try {
251
+ read = await readBounded(response.body, maxBytes);
252
+ }
253
+ catch (e) {
254
+ if (signal.aborted)
255
+ throw describeFailure(url, e, signal, timedOut, timeoutMs);
256
+ throw new ToolError('RESULT_UNKNOWN', `本文の受信が途中で失敗した(欠けている可能性がある): ${e.message}`);
257
+ }
258
+ if (signal.aborted)
259
+ throw describeFailure(url, undefined, signal, timedOut, timeoutMs);
260
+ const contentType = response.headers.get('content-type');
261
+ const head = [
262
+ `GET ${target.href}`,
263
+ `状態: ${response.status} ${response.statusText}`.trimEnd(),
264
+ `content-type: ${contentType ?? '(なし)'}`,
265
+ `受信: ${read.total} バイト${read.truncated ? `(上限 ${maxBytes} バイトで打ち切り)` : ''}`,
266
+ ...(url.href !== target.href ? [`最終URL: ${url.href}`] : []),
267
+ ...(hops.length ? [`転送: ${hops.length} 回`] : []),
268
+ ];
269
+ if (!isTextual(contentType)) {
270
+ return [...head, '', '本文はテキストではないため表示しない(バイナリ)。'].join('\n');
271
+ }
272
+ if (read.bytes.byteLength === 0)
273
+ return [...head, '', '本文は空。'].join('\n');
274
+ const raw = decodeBody(read.bytes, contentType);
275
+ const bodyText = isHtml(contentType) ? htmlToText(raw) : raw;
276
+ const clipped = clipText(bodyText, TEXT_BUDGET);
277
+ return [
278
+ ...head,
279
+ '',
280
+ isHtml(contentType) ? '本文(HTML→テキスト):' : '本文:',
281
+ clipped.text.length ? clipped.text : '(本文なし)',
282
+ ...(clipped.clipped ? [`…(本文は上限 ${TEXT_BUDGET} 文字で打ち切り。残り ${clipped.clipped} 文字)`] : []),
283
+ ...(read.truncated ? ['…(受信は上記のバイト上限で打ち切り。続きは未取得)'] : []),
284
+ ].join('\n');
285
+ }
286
+ },
287
+ };
288
+ }
289
+ /** Brave の応答から必要な3項目だけを取り出す。形が違う場合は失敗として返す。 */
290
+ export function parseBraveResults(body, limit) {
291
+ const results = body?.web?.results;
292
+ if (!Array.isArray(results))
293
+ return [];
294
+ const out = [];
295
+ for (const row of results) {
296
+ if (out.length >= limit)
297
+ break;
298
+ if (typeof row?.url !== 'string' || !row.url.startsWith('http'))
299
+ continue;
300
+ out.push({
301
+ title: htmlToText(typeof row.title === 'string' ? row.title : ''),
302
+ url: row.url,
303
+ description: htmlToText(typeof row.description === 'string' ? row.description : ''),
304
+ });
305
+ }
306
+ return out;
307
+ }
308
+ export function createWebSearchTool(options = {}) {
309
+ const endpoint = options.searchEndpoint ?? BRAVE_ENDPOINT;
310
+ const lookup = options.keyLookup ?? ((env) => resolveApiKey(BRAVE_PROVIDER, env, BRAVE_ENV));
311
+ return {
312
+ readOnly: true,
313
+ name: 'web_search',
314
+ description: 'Web検索を1回行い、タイトル・URL・要約だけを返す(本文は fetch_url で取る)。'
315
+ + `ワークスペース外への通信なので毎回承認を求める。キーは環境変数 ${BRAVE_ENV} か保存済みキー(${BRAVE_PROVIDER})を使う。`,
316
+ parameters: {
317
+ type: 'object',
318
+ properties: {
319
+ query: { type: 'string', maxLength: 400, description: '検索語(1〜400文字)' },
320
+ count: { type: 'number', description: '件数(1〜10、既定5)' },
321
+ },
322
+ required: ['query'],
323
+ },
324
+ operationIdentity: (args) => ({ query: typeof args.query === 'string' ? args.query.trim() : '', count: args.count ?? 5 }),
325
+ async execute(args, ctx) {
326
+ const query = typeof args.query === 'string' ? args.query.trim() : '';
327
+ if (!query || query.length > 400 || /[\r\n\0]/.test(query)) {
328
+ throw new ToolError('INVALID_ARGS', 'query は1〜400文字で改行を含まない文字列で指定する');
329
+ }
330
+ const count = positiveInt(args.count, 'count', 10) ?? 5;
331
+ const key = lookup(process.env);
332
+ if (!key) {
333
+ throw new ToolError('NO_KEY', `検索にはAPIキーが必要(環境変数 ${BRAVE_ENV} か、/keys の保存先に ${BRAVE_PROVIDER} を登録する)`);
334
+ }
335
+ const url = new URL(endpoint);
336
+ url.searchParams.set('q', query);
337
+ url.searchParams.set('count', String(count));
338
+ if (ctx.signal?.aborted)
339
+ throw new ToolError('NOT_EXECUTED', '中断済みのため実行しない');
340
+ const ok = await ctx.approval.approve({
341
+ kind: 'command',
342
+ title: `Web検索 (${url.host})`,
343
+ detail: `GET ${url.href}\nクエリ: ${query}\n件数: ${count} 件まで\n\n検索語と利用状況が外部サービスへ送られる。`,
344
+ outsideWorkspace: true,
345
+ ...(ctx.signal ? { signal: ctx.signal } : {}),
346
+ });
347
+ if (!ok)
348
+ throw new ToolError('DENIED', '承認されなかったため実行しない');
349
+ if (ctx.signal?.aborted)
350
+ throw new ToolError('NOT_EXECUTED', '中断済みのため実行しない');
351
+ const { signal, timedOut } = signalFor(ctx, options.timeoutMs ?? SEARCH_TIMEOUT_MS);
352
+ let response;
353
+ try {
354
+ response = await fetch(url, {
355
+ method: 'GET',
356
+ redirect: 'error',
357
+ signal,
358
+ headers: { accept: 'application/json', 'x-subscription-token': key },
359
+ });
360
+ }
361
+ catch (e) {
362
+ throw describeFailure(url, e, signal, timedOut, options.timeoutMs ?? SEARCH_TIMEOUT_MS);
363
+ }
364
+ if (!response.ok) {
365
+ await response.body?.cancel().catch(() => { });
366
+ // キーは応答にも要求にも出さない。状態だけを返す。
367
+ throw new ToolError('SEARCH_FAILED', `検索APIが失敗した: ${response.status} ${response.statusText}`.trimEnd());
368
+ }
369
+ let body;
370
+ try {
371
+ body = await response.json();
372
+ }
373
+ catch {
374
+ throw new ToolError('RESULT_UNKNOWN', '検索結果をJSONとして読めなかった(結果不明)');
375
+ }
376
+ const hits = parseBraveResults(body, count);
377
+ if (hits.length === 0)
378
+ return `検索 "${query}": 0 件。結果の形が想定と違うか、該当なし。`;
379
+ const lines = hits.map((hit, i) => `${i + 1}. ${hit.title || '(無題)'}\n ${hit.url}${hit.description ? `\n ${hit.description}` : ''}`);
380
+ return [`検索 "${query}": ${hits.length} 件(上限 ${count} 件)`, ...lines].join('\n');
381
+ },
382
+ };
383
+ }
384
+ export const fetchUrlTool = createFetchUrlTool();
385
+ export const webSearchTool = createWebSearchTool();
386
+ export const webTools = [fetchUrlTool, webSearchTool];
@@ -0,0 +1,30 @@
1
+ # CIとCL+SSL依存ロードの修正
2
+
3
+ 2026-11-16 JST。実装先 `/Users/dkc/Sites/Src/mdkh`、開始HEAD `59d4dd7`。
4
+
5
+ ## 確認したCI
6
+
7
+ [run 43768392131](https://github.com/askdkc/MoDKH/actions/runs/43768392131)、対象 `b84ab3d`。
8
+
9
+ - Ubuntu:424成功・18失敗・10skip。17件がSBCL欠落に伴う失敗、1件がTUIの表記不一致。
10
+ - macOS:425成功・19失敗・8skip。上記に加えてバックグラウンドジョブの終了判定試験が失敗。
11
+ - 両OSともbuildは成功。tarball受入工程はテスト失敗により未実行。
12
+
13
+ workflowにLinuxのSBCL/build-essential導入とmacOSのSBCL導入を追加。実行前にSBCL/ASDF・cc・makeを確認する。従来buildのみだった工程でtypecheckも実行する。TUI試験の期待表記を実仕様の `MoDKH` に修正。ジョブ試験は経過時間で完了を仮定せず、呼出元が子の後半を解放し、増分出力と実際の完了状態を別々に確認する。
14
+
15
+ ## 追加で報告されたCommon Lisp障害
16
+
17
+ ユーザーの新しい `last-failure.json` で、`runtime-warmup` の `TRIVIAL-GRAY-STREAMS not found` を確認。専用Quicklisp環境で `cl+ssl/config` のみをロードした後、ASDFにCL+SSL全体の強制ロードを要求していた。ASDFは不足した依存を取得しないため、先に `ql:quickload "cl+ssl"` で依存を解決するよう修正した。
18
+
19
+ 実SBCLの隔離fixtureで、依存が未登録の旧順序は失敗し、Quicklisp役が依存ASDを供給する新順序は成功することを確認。これは実Quicklispのネットワーク取得試験ではない。実CL-LSP全体の起動成功も未確認。
20
+
21
+ ## 最終検証
22
+
23
+ - `npm run typecheck` / `npm run build` / `git diff --check`:成功。YAML構文チェック成功。
24
+ - 関連63試験成功(jobs、Lisp設定・委譲、Common Lisp、packed grammar)。
25
+ - source入口と再build済みdist入口をTTYストリームとして起動し、MoDKH表示と `/exit` の終了0を確認。初回の補助probeはTERM=dumbを引き継いでplain表示になりタイムアウトしたため、実CI試験と同じTERMで再確認した。HTTP通信を含む全TUI試験の成功とは区別する。
26
+ - `npm test`:457件、391成功・58失敗・8skip。58失敗の名前・error・codeは履歴 `tls-fix/full-final.log` と一致。ローカル実行環境のHTTP待受EPERM57件、watch EMFILE1件。GitHub上の18/19失敗とは異なる。
27
+ - `sh scripts/acceptance.sh`:tarball作成後、隔離インストールで `registry.npmjs.org` のENOTFOUND。受入成功とは扱わない。
28
+ - 証跡:`.dkh-feasibility/ci-repair/`。source/dist digestは同ディレクトリの `identity.json`。
29
+
30
+ 既存・並行編集のREADMEとドキュメントは保持。グローバル環境更新・commit・pushは未実施。修正後のGitHub Actions実行は未確認。
@@ -0,0 +1,22 @@
1
+ # Common Lispサーバー切替(2026-11-16)
2
+
3
+ 現在のMacリポジトリで、自動導入元を `askdkc/cl-lsp` に変更。
4
+
5
+ - 専用領域に新しいcheckoutを取得し、付属 `scripts/install-headless.ros --prefix` で構築する。依存は `vendor/`。取得revision、同梱ソース一覧・installer・launcherのdigestを記録。
6
+ - 旧Lemの追加取得、Qlot、独自ASDFレジストリ修復、Autotools、CL+SSL/OpenSSL選択コードを削除。不要になった専用テストを、新しい導入契約と失敗経路のテストに置換。
7
+ - 旧提供元の成功receiptを再利用しない。旧提供元の失敗キャッシュで新しい導入を停止させない。autoInstall=falseは従来どおり通信・書込みを行わない。
8
+ - 実initialize、ファイル同期、定義応答によるready判定、未評価global定義と診断の観測、SBCL補助診断の非評価境界は維持。
9
+ - 手動手順は `ros install askdkc/cl-lsp`。既存のグローバル設定やインストールは変更していない。
10
+
11
+ ## 検証
12
+
13
+ Darwin arm64。既存のローカル `askdkc/cl-lsp` checkout(clean、revision `594f9be291159e146fc2d51d3c3b56f93f227a7c`)をリポジトリ内の検証専用snapshotにコピー。private HOME/ROSWELL_HOMEと既存のsystem SBCLで、新しいMoDKH導入関数を実行し、ネイティブ/Lispビルドと生成ランチャーの `--help` が成功した。ネットワークからの冷開始取得試験とは区別する。
14
+
15
+ 生成ランチャーを実LSPクライアントから `--stdio` で起動。最初の8秒期限では初期化が完了せず、45秒期限で再確認すると `USOCKET:OPERATION-NOT-PERMITTED-ERROR` が記録された。内部ソケットが実行環境に拒否され、initializeはタイムアウト。両試行とも終了処理は確認済み。同期・定義・診断の実応答には到達していない。未応答をreadyに変更していない。
16
+
17
+ - 最終sourceの型検査・build・`git diff --check`:成功。dist再生成済み。
18
+ - Common Lisp・Roswell関連:17成功。
19
+ - 全体:450件、384成功・58失敗・8skip。58失敗は履歴 `ci-repair/full-final.log` と試験名・error・codeが一致(HTTP EPERM57、watch EMFILE1)。旧依存処理の削除に伴い全試験数は減っている。
20
+ - Linux実動作、ネットワークからの全自動導入、グローバル版への反映は未検証/未実施。PLAN全体は未完了。
21
+
22
+ 証跡:`.dkh-feasibility/askdkc-cl-lsp/`(build-receipts.json、lsp-45s.json、full-final.log、comparison.json、identity.json)。commit・pushは行っていない。
@@ -0,0 +1,28 @@
1
+ # CL-LSP導入のQlot判定修正
2
+
3
+ 2026-11-15、`/Users/dkc/Sites/Src/mdkh`、HEAD `018c1bc` に対する未コミット変更。Darwin arm64。開始時の作業ツリーはclean。
4
+
5
+ ## 実測と修正
6
+
7
+ ユーザー環境の `last-failure.json` はQlot bootstrap成功後、`qlot-capability` が stdout `Qlot 1.8.4\n`、stderr空、exit255、cleanup settledで停止していた。
8
+
9
+ [Qlot CLI](https://github.com/fukamachi/qlot/blob/master/src/cli.lisp) の `--version` は `print-version` 後に `(uiop:quit -1)` を呼ぶ。この終了を導入失敗と扱ったMoDKH側のバグ。255全般を許容せず、RoswellからASDFの `qlot/cli` ロード、関数の存在、版情報付き専用証跡を確認する方式に変更した。正常終了と終了処理の確認も必要。
10
+
11
+ [async-process ASD](https://github.com/lem-project/async-process/blob/master/src/async-process.asd) は `src/` にあり、[GNUmakefile](https://github.com/lem-project/async-process/blob/master/GNUmakefile) は親にある。旧コードはASDのディレクトリでmakeしていた。所有領域内の実ソースからビルド入口を探索し、欠落時は拒否する。Autoconf・Automake・Libtoolの能力確認を追加。macOSではHomebrewのglibtoolizeを確認する。
12
+
13
+ 失敗メッセージにstdoutとcleanupを追加。定義参照probeは空白のcharacter16から、参照するvalueの開始位置17に修正した。ただし実CL-LSPでの定義応答は今回未検証。
14
+
15
+ ## 検証
16
+
17
+ - `npm run typecheck`: 成功。
18
+ - `npm run build`: 成功、文法12件・スキル17件。同じsourceからdistを再生成。
19
+ - `node --test test/language.commonlisp*.test.ts test/language.roswell-archive.test.ts`: 最終変更後19成功。
20
+ - 実SBCLの回帰試験で旧version判定が255になること、新しい生成probeがfixture CLIをロードして専用証跡を返すことを確認。実Qlot全体の再導入試験とは区別する。
21
+ - `npm test`: 最終変更後452件、386成功・58失敗・8skip。
22
+ - 58失敗は履歴ログ `namespace/full.log` と試験名・error・codeを重複も含め照合し一致。57 HTTP EPERM、1 watch EMFILE。変更直前の全体再実行との比較ではない。
23
+ - skipはLean6件(transitive sorry、sorry、false theorem、custom axiom、generated axiom、true theorem)、TLC2件(good.cfg、bad.cfg)。必要runtime/設定なし。
24
+ - `git diff --check`: 成功。
25
+
26
+ 再ビルド済み `dist/language/commonlisp-install.js` から、リポジトリ内の空の専用領域に実導入を試行。`release-metadata` で `ENOTFOUND: getaddrinfo ENOTFOUND api.github.com`。ユーザーのQlotまで進んだ実行とは別の制限。実CL-LSP起動・同期・定義・診断は未検証。Linux実機も未検証。PLAN全体は未完了。
27
+
28
+ ログは `.dkh-feasibility/qlot-exit-fix/`。source SHA256: `6b47e6ef35178575382eb62e57ebdc91e333c688b2033d9a652a02f095fedf50`。dist SHA256: `10376e47264238d2eda156d78f2ca81a1ca5b7265da9fff5a251dfab4839fe48`(`scripts/modkh-source-identity.mjs`)。グローバルインストール・commit・pushは行っていない。
@@ -0,0 +1,28 @@
1
+ # macOSのQlot / CL+SSL修正(2026-11-16 JST)
2
+
3
+ 対象は `/Users/dkc/Sites/Src/mdkh`、Darwin arm64。既存のロゴ変更とREADMEの編集用ファイルには触れていない。
4
+
5
+ ## 原因と変更
6
+
7
+ ユーザーの `last-failure.json` の `lem-dependencies` には、`The alien function "ASN1_STRING_data" is undefined.` が記録されていた。今回の直接原因はDNSではない。Qlotが案内した詳細ログは、MoDKHの失敗後cleanupによって既に削除されていた。
8
+
9
+ このMacの `/opt/homebrew/opt/openssl/lib/libcrypto.dylib` は `ASN1_STRING_get0_data` を提供するが `ASN1_STRING_data` を提供しない。CL+SSLの実ソースは後者を使用する。標準の選択で実SBCLから同じエラー(exit1)を再現した。
10
+
11
+ - macOSのHomebrew配下にあるOpenSSLのペアを探索し、別プロセスで実ロードして必要なAPIを確認する。バージョン番号で合否を決めない。今回は標準のライブラリを拒否し、既存の `/opt/homebrew/Cellar/openssl@3/3.5.9/lib` を選択した。コードにこの版は固定していない。
12
+ - CL+SSLの公式設定APIでライブラリの実パスを指定し、再コンパイルして、別ライブラリ向けのコンパイル済み条件分岐を持ち越さない。Qlotは設定を読み込んだRoswellプロセスから呼ぶ。CL-LSPの起動準備にも同じ設定を渡す。
13
+ - コンパイル出力はstderrに流し、LSPのstdoutを汚さない。証明書検証の無効化、HTTPへの置換、Homebrewのリンク変更は行わない。
14
+ - 失敗時の `qlot-error-*.log` は、通常ファイルかつ2 MiB以下のものを `last-failure.json` の `diagnostics` に保存してから作業領域を削除する。
15
+
16
+ 参照した実ソース:[Qlot HTTP](https://github.com/fukamachi/qlot/blob/master/src/http.lisp)、[CL+SSL FFI](https://github.com/cl-plus-ssl/cl-plus-ssl/blob/master/src/ffi.lisp)、[CL+SSLライブラリ選択](https://github.com/cl-plus-ssl/cl-plus-ssl/blob/master/src/reload.lisp)。ローカルCL+SSLの `src/config.lisp` で明示設定APIも確認した。
17
+
18
+ ## 最終検証
19
+
20
+ - 実SBCL / 実CL+SSL:標準設定は同じ未定義関数エラー。生成した修正設定ではASN1文字列を作成し、`ASN1_STRING_data` を呼び、解放してexit0。stdoutは専用成功証跡のみ。この試験はローカルASDF依存を使用し、Quicklispのダウンロードは行っていない。
21
+ - `npm run typecheck`、`npm run build`、`git diff --check`:成功。
22
+ - `node --test test/language.commonlisp*.test.ts`:21成功。ロード対象のAPI欠損、未完了出力、TLS設定の順序、失敗ログ保存を含む。
23
+ - `npm test`:456件、390成功・58失敗・8skip。履歴 `qlot-exit-fix/full-final.log` と58件の試験名・error・codeが一致。HTTP待受EPERM57件、watch EMFILE1件。変更直前の新規実行との比較ではない。
24
+ - skipはLean6件とTLC2件で、必要runtimeまたは設定がない既存試験。
25
+
26
+ 詳細ログとsource/distの同一性記録:`.dkh-feasibility/tls-fix/`。最終sourceからdistを再ビルドした。グローバル版の更新・commit・pushはしていない。
27
+
28
+ CL-LSPの冷開始からの依存取得、initialize、定義参照、診断までの通し試験は今回未実施。今回実証したのは、このMacでのCL+SSLエラーの再現と解消、導入コードへの接続、回帰試験の範囲。Linuxの実ライブラリ試験は行っていない。PLAN全体は未完了。
@@ -0,0 +1,100 @@
1
+ # 目的別スキルとモデル入力の節約
2
+
3
+ 通常のMODKHチャットとローカル子エージェントで自動的に有効です。追加のモデル呼び出し・パッケージ・Kiokuko接続は不要です。外部エージェントの内部プロンプトは対象外です。
4
+
5
+ ## 目的別スキル
6
+
7
+ kiokuko-dshのスキル17件と参照資料を含む43ファイルを、原文のまま `skills/kiokuko-dsh/` に同梱しています。独自の短い `modkh-*` 代用品は廃止しました。
8
+
9
+ | 選択条件 | 注入するスキル |
10
+ | --- | --- |
11
+ | スキル適用時の入口 | `kiokuko-soul` |
12
+ | コードの実装・修正 | `coding-ideal-routine-skill`、`one-shot-software-completion`、`kiokuko-single-purpose-functions` |
13
+ | 調査・設計・レビュー | `kiokuko-investigate`、`kiokuko-architecture`、`kiokuko-review` |
14
+ | 性能・検証 | `kiokuko-benchmark`、`kiokuko-verification` |
15
+ | 小さな変更・導入や状態の変更 | `kiokuko-simple-work`、`veteran-programmer-skill` |
16
+ | UI | `kiokuko-ui-design-soul` |
17
+ | スキル・技術文書の作成 | `kiokuko-skill-authoring`、`kiokuko-technical-writing` |
18
+ | 記憶・Lisp | `memory-reasoning`、`kiokuko-lisp` |
19
+ | 日本語の依頼、またはJapanese指定 | `natural-japanese-output` |
20
+
21
+ 日本語・英語のキーワード一致で選び、`$kiokuko-review` のような明示指定を優先します。意味を理解する分類器ではなく、否定や引用も意味解析しません。任意の専門スキルは最大3件で、SOUL・コーディングの共通手順・日本語出力は別枠です。合計の注入上限は48 KiBです。旧12 KiB制限では実際の共通手順さえ収まらないため変更しています。利用者の実際の依頼・既存の上位指示・ツール承認が常に優先されます。
22
+
23
+ スキル内で著者が `kiokuko:runtime` と指定した部分は全て保持し、`documentation` 部分だけを初期注入から除きます。未分類のスキルはfrontmatterを除いて全文を保持します。独自の要約で規則を削りません。
24
+
25
+ モデルは `list_skills` で17件の名前・説明・参照パスを確認し、`read_skill` で必要な本文・詳細資料を読みます。`resource` は一覧にある相対パスだけを受け付けます。長い本文には `nextLine` が返り、`startLine` に指定して続きを取得できます。組み込みworker/explorerにも両ツールを公開しています。独自の子プラグインは必要に応じて許可ツール一覧へ追加してください。
26
+
27
+ DSH固有の `kioku_*`、`lisp_*`、Akinator、Goal、lease、`coding_workflow`、`task_completion` はMODKHにはありません。注入時・参照読み取り時にMODKHの適用規則を付け、存在しないAPIの呼び出し・導入・完了待ちを禁止し、実際のMODKHツールと承認に従わせます。Lispワーカーや自動記憶保存そのものを移植したという意味ではありません。
28
+
29
+ 本文を途中で切ると制約が落ちるため、予算に入らない本文は丸ごと省略して通知します。完全一致する本文も一度だけ注入します。手順は一つの依頼中では固定し、モデルに送るsystem入力にだけ追加します。セッション履歴へ書き込まないため、再開・ツール往復による蓄積を防ぎます。次の依頼では選び直し、ローカルファイルの更新も読み直します。表示のbytesは注入テキストのUTF-8サイズであり、トークン数ではありません。
30
+
31
+ ### プロジェクト固有のスキル
32
+
33
+ 作業ルートの `.modkh/skills.json` に、既存の手順ファイルを登録できます。
34
+
35
+ ```json
36
+ [
37
+ {
38
+ "name": "php-project",
39
+ "description": "このプロジェクトのPHP実装手順",
40
+ "keywords": ["PHP", "Laravel", "Eloquent"],
41
+ "path": "docs/php-workflow.md"
42
+ }
43
+ ]
44
+ ```
45
+
46
+ `PHPの処理を調査` などのキーワード一致、または `$php-project` の明示指定で本文を読みます。`description` は説明用で、選択には `keywords` を使用します。全本文の事前注入や自動ダウンロードは行いません。既存の `SKILL.md` もpathで指定できますが、本文全体をそのまま扱うため、実行手順だけの短いファイルを推奨します。
47
+
48
+ - 名前は英小文字で始まる英小文字・数字・ハイフン、最大64文字。重複・組み込み名の上書きは不可。
49
+ - 一覧は64 KiB・128件まで。keywordsは32件まで、各1〜80文字。descriptionは500文字まで。
50
+ - pathは作業ルート内の相対パス。範囲外へ解決されるシンボリックリンク、通常ファイルでないもの、12 KiBを超える本文は注入しません。
51
+ - 不正な一覧・読めない本文は通知して通常の作業を続けます。未選択の本文は読みません。
52
+ - `.modkh/` をgitignoreしている場合、一覧を共有するには明示的に管理対象にしてください。
53
+ - 埋め込み利用では `runAgentLoop` の `skills: false` で注入を無効化できます。
54
+
55
+ ## ツール出力
56
+
57
+ AI SDK経由とChatGPT Responses経由の両方で、モデルに渡す投影だけを変更します。保存済みの原文・call ID・status・承認・再実行防止は変更しません。
58
+
59
+ 1. 連続して同じ行が現れる出力は、文字列と回数のJSONへ可逆変換します。改行・順序・末尾文字列を保持し、説明を含めてもUTF-8サイズが小さくなるときだけ採用します。対象は1,024〜2,000,000 UTF-16コード単位です。
60
+ 2. それでも1件16 KiBの枠を超える場合、原文の先頭と末尾を残し、中間省略を明示します。圧縮JSONを途中で切ることはしません。
61
+ 3. 既存の全体128 KiB枠は新しい結果から割り当てます。枠を使い切った古い結果にも省略通知が残るため、通知・APIの外枠を含む総リクエストが128 KiB以内になる保証ではありません。
62
+
63
+ 一般的な会話の要約や自動削除は行いません。実プロバイダーのトークン数・キャッシュ・請求額の削減率は未測定です。可逆な文字数削減が、そのまま料金削減率になるとは限りません。
64
+
65
+ ## 参考実装と検証
66
+
67
+ [kiokuko-dsh](https://github.com/askdkc/kiokuko-dsh) のローカル参照コミット `795172935041acb29718860458a59501a98fd466` にある、目的別選択、実行手順と文書の分離、重複注入回避、可逆な反復文字列圧縮を参考にMODKHのループへ独立実装しました。KiokukoのDB・タスク状態・モデルによるスキル選択・意味的要約は移植していません。スキルセットは後続の修正で `88dac41e9f92d4638a214825b40e6967499be961` から同梱しました。`manifest.json` に全43ファイルのSHA-256を記録し、読み込み時とビルド時に検証します。MITライセンスも同梱しています。
68
+
69
+ ```sh
70
+ node --test test/bundled.skills.test.ts test/skills.context.test.ts test/context.efficiency.test.ts
71
+ npm run typecheck
72
+ npm run build
73
+ node scripts/verify-skill-package.mjs
74
+ npm test
75
+ ```
76
+
77
+ 2026-11-15の検証では、旧ループを隔離コピーに戻すとスキル注入テストが失敗することを確認しています。全体テストにはローカルHTTPサーバーとファイル監視を使うケースがあるため、それらを許可した環境での実行が必要です。
78
+
79
+ ### 初回の確認結果(スキルセット同梱前)
80
+
81
+ 対象はMODKH `7a93e8c731e4fcec190ee09986bedf1756412f11` を基点とする今回の変更です。
82
+
83
+ - `npm run typecheck`、`npm run build`、`git diff --check`: 成功。
84
+ - `node --test test/bundled.skills.test.ts test/skills.context.test.ts test/context.efficiency.test.ts test/agent.loop.test.ts test/subagents.service.test.ts`: 36件成功。
85
+ - `npm test`: 366件中308件成功、58件失敗。57件はローカルHTTP待受の `EPERM`、1件は `fs.watch` の `EMFILE`。追加のAI SDK送信形式テストは、その後の関連36件に含めて成功。HTTP結合テストは未検証。
86
+ - ビルド済み `dist/index.js` を一時的な作業ルート・専用の `MODKH_HOME`・`fixed/scripted` で実行し、`modkh-debug` 選択表示、README編集、コマンドのマーカー作成、終了コード0を確認。実プロバイダーによる課題解決能力の検証ではない。
87
+ - 隔離コピーで旧ループに戻すと注入テストが失敗。圧縮を無効にする変更、末尾を捨てる変更も、それぞれ回帰テストが検出。
88
+ - 合成反復ログは90,010 bytes → 176 bytes。これはこの入力のUTF-8サイズ比較に限定され、トークン・料金の測定ではない。
89
+
90
+ グローバルにインストール済みのMODKHの更新・動作確認、実プロバイダーへの通信は行っていません。
91
+
92
+ ### スキルセット同梱後の確認結果
93
+
94
+ - 17スキル・26参照資料(計43ファイル)が移植元とバイト単位で一致。全ファイルのSHA-256検証とruntimeブロック抽出が成功。
95
+ - `npm run typecheck`、`npm run build`、`git diff --check`: 成功。
96
+ - `node --test test/bundled.skills.test.ts test/skills.context.test.ts test/context.efficiency.test.ts test/agent.loop.test.ts test/subagents.service.test.ts test/tools.guard.test.ts`: 53件成功。
97
+ - `npm test`: 373件中315件成功、58件失敗。ローカルHTTP待受の `EPERM` 57件、ファイル監視の `EMFILE` 1件。これらの結合検証は未完了。
98
+ - `node scripts/verify-skill-package.mjs`: npm packした配布物を一時ディレクトリへ展開し、別の作業ルートで実際の共通ループからコーディング手順・UI手順を注入、`read_skill` で参照資料を取得できた。隔離した配布物の本文を改変するとハッシュ検証が拒否することも確認。
99
+ - 先に追加したコーディング受け入れテストは、同梱・接続前には `missing kiokuko-soul` で失敗し、導入後に成功。
100
+ - 注入量の例: 英語のバグ修正29,772 bytes、日本語のUI修正38,379 bytes、Lispコード実装45,929 bytes。全17件の一括注入ではなく、必要な共通手順と専門手順を選択した結果。実トークン数・料金・実モデルが手順へ従う品質は未測定。