modkh 0.0.0-stage → 0.2.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.
- package/README.md +66 -2
- package/dist/agent/bundled-skills.d.ts +13 -0
- package/dist/agent/bundled-skills.js +95 -0
- package/dist/agent/compaction.d.ts +53 -0
- package/dist/agent/compaction.js +191 -0
- package/dist/agent/images.d.ts +10 -0
- package/dist/agent/images.js +33 -0
- package/dist/agent/loop.d.ts +103 -0
- package/dist/agent/loop.js +267 -0
- package/dist/agent/skills.d.ts +26 -0
- package/dist/agent/skills.js +190 -0
- package/dist/agent/types.d.ts +137 -0
- package/dist/agent/types.js +12 -0
- package/dist/cli/agenticreplay.d.ts +1 -0
- package/dist/cli/agenticreplay.js +66 -0
- package/dist/cli/agents.d.ts +8 -0
- package/dist/cli/agents.js +12 -0
- package/dist/cli/answer-markdown.d.ts +3 -0
- package/dist/cli/answer-markdown.js +29 -0
- package/dist/cli/approval.d.ts +29 -0
- package/dist/cli/approval.js +92 -0
- package/dist/cli/catalog.d.ts +37 -0
- package/dist/cli/catalog.js +46 -0
- package/dist/cli/chat.d.ts +18 -0
- package/dist/cli/chat.js +1061 -0
- package/dist/cli/clipboard.d.ts +11 -0
- package/dist/cli/clipboard.js +82 -0
- package/dist/cli/color.d.ts +59 -0
- package/dist/cli/color.js +244 -0
- package/dist/cli/compaction-settings.d.ts +21 -0
- package/dist/cli/compaction-settings.js +54 -0
- package/dist/cli/completion-art.d.ts +2 -0
- package/dist/cli/completion-art.js +62 -0
- package/dist/cli/config.d.ts +50 -0
- package/dist/cli/config.js +192 -0
- package/dist/cli/editor.d.ts +23 -0
- package/dist/cli/editor.js +115 -0
- package/dist/cli/file-mentions.d.ts +14 -0
- package/dist/cli/file-mentions.js +141 -0
- package/dist/cli/head-checks.d.ts +41 -0
- package/dist/cli/head-checks.js +146 -0
- package/dist/cli/initial-connection.d.ts +7 -0
- package/dist/cli/initial-connection.js +20 -0
- package/dist/cli/keys.d.ts +29 -0
- package/dist/cli/keys.js +107 -0
- package/dist/cli/language.d.ts +1 -0
- package/dist/cli/language.js +105 -0
- package/dist/cli/limits.d.ts +13 -0
- package/dist/cli/limits.js +19 -0
- package/dist/cli/lines.d.ts +18 -0
- package/dist/cli/lines.js +80 -0
- package/dist/cli/model-catalog.d.ts +16 -0
- package/dist/cli/model-catalog.js +130 -0
- package/dist/cli/models.d.ts +4 -0
- package/dist/cli/models.js +101 -0
- package/dist/cli/official-models.d.ts +6 -0
- package/dist/cli/official-models.js +77 -0
- package/dist/cli/pdf.d.ts +8 -0
- package/dist/cli/pdf.js +71 -0
- package/dist/cli/permissions.d.ts +25 -0
- package/dist/cli/permissions.js +30 -0
- package/dist/cli/plugins.d.ts +1 -0
- package/dist/cli/plugins.js +53 -0
- package/dist/cli/providers.d.ts +10 -0
- package/dist/cli/providers.js +82 -0
- package/dist/cli/shell-display.d.ts +6 -0
- package/dist/cli/shell-display.js +35 -0
- package/dist/cli/stateright.d.ts +1 -0
- package/dist/cli/stateright.js +37 -0
- package/dist/cli/terminal-mouse.d.ts +21 -0
- package/dist/cli/terminal-mouse.js +51 -0
- package/dist/cli/terminal.d.ts +231 -0
- package/dist/cli/terminal.js +1417 -0
- package/dist/cli/tool-display.d.ts +9 -0
- package/dist/cli/tool-display.js +87 -0
- package/dist/cli/transcript-selection.d.ts +22 -0
- package/dist/cli/transcript-selection.js +75 -0
- package/dist/cli/usage.d.ts +22 -0
- package/dist/cli/usage.js +117 -0
- package/dist/cli/waiting-nyan.d.ts +3 -0
- package/dist/cli/waiting-nyan.js +17 -0
- package/dist/cli/waiting-whales.d.ts +3 -0
- package/dist/cli/waiting-whales.js +24 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.js +186 -0
- package/dist/language/catalog.d.ts +44 -0
- package/dist/language/catalog.js +100 -0
- package/dist/language/commonlisp-bundled.d.ts +11 -0
- package/dist/language/commonlisp-bundled.js +22 -0
- package/dist/language/commonlisp-dependencies.d.ts +16 -0
- package/dist/language/commonlisp-dependencies.js +68 -0
- package/dist/language/commonlisp-install.d.ts +15 -0
- package/dist/language/commonlisp-install.js +214 -0
- package/dist/language/commonlisp-reader.d.ts +17 -0
- package/dist/language/commonlisp-reader.js +47 -0
- package/dist/language/commonlisp-systems.d.ts +3 -0
- package/dist/language/commonlisp-systems.js +32 -0
- package/dist/language/commonlisp-tls.d.ts +10 -0
- package/dist/language/commonlisp-tls.js +51 -0
- package/dist/language/detect.d.ts +29 -0
- package/dist/language/detect.js +103 -0
- package/dist/language/grammars/LICENSE +24 -0
- package/dist/language/grammars/manifest.json +76 -0
- package/dist/language/grammars/tree-sitter-c.wasm +0 -0
- package/dist/language/grammars/tree-sitter-cpp.wasm +0 -0
- package/dist/language/grammars/tree-sitter-css.wasm +0 -0
- package/dist/language/grammars/tree-sitter-html.wasm +0 -0
- package/dist/language/grammars/tree-sitter-javascript.wasm +0 -0
- package/dist/language/grammars/tree-sitter-php.wasm +0 -0
- package/dist/language/grammars/tree-sitter-python.wasm +0 -0
- package/dist/language/grammars/tree-sitter-ruby.wasm +0 -0
- package/dist/language/grammars/tree-sitter-rust.wasm +0 -0
- package/dist/language/grammars/tree-sitter-swift.wasm +0 -0
- package/dist/language/grammars/tree-sitter-tsx.wasm +0 -0
- package/dist/language/grammars/tree-sitter-typescript.wasm +0 -0
- package/dist/language/install.d.ts +50 -0
- package/dist/language/install.js +293 -0
- package/dist/language/lsp/client.d.ts +97 -0
- package/dist/language/lsp/client.js +340 -0
- package/dist/language/lsp/pool.d.ts +75 -0
- package/dist/language/lsp/pool.js +140 -0
- package/dist/language/lsp/service.d.ts +50 -0
- package/dist/language/lsp/service.js +174 -0
- package/dist/language/native.d.ts +8 -0
- package/dist/language/native.js +100 -0
- package/dist/language/platform.d.ts +14 -0
- package/dist/language/platform.js +20 -0
- package/dist/language/positions.d.ts +20 -0
- package/dist/language/positions.js +46 -0
- package/dist/language/syntax/assets.d.ts +9 -0
- package/dist/language/syntax/assets.js +73 -0
- package/dist/language/syntax/parser.d.ts +33 -0
- package/dist/language/syntax/parser.js +162 -0
- package/dist/language/typescript-capability.d.ts +6 -0
- package/dist/language/typescript-capability.js +42 -0
- package/dist/lisp/builtin-agents.d.ts +5 -0
- package/dist/lisp/builtin-agents.js +52 -0
- package/dist/lisp/config.d.ts +25 -0
- package/dist/lisp/config.js +202 -0
- package/dist/lisp/routing.d.ts +5 -0
- package/dist/lisp/routing.js +24 -0
- package/dist/lisp/runtime.d.ts +26 -0
- package/dist/lisp/runtime.js +107 -0
- package/dist/memory/kiokuko.d.ts +32 -0
- package/dist/memory/kiokuko.js +102 -0
- package/dist/memory/mcp.d.ts +38 -0
- package/dist/memory/mcp.js +211 -0
- package/dist/model/ai-sdk.d.ts +27 -0
- package/dist/model/ai-sdk.js +185 -0
- package/dist/model/chatgpt/login.d.ts +42 -0
- package/dist/model/chatgpt/login.js +180 -0
- package/dist/model/chatgpt/responses.d.ts +41 -0
- package/dist/model/chatgpt/responses.js +254 -0
- package/dist/model/chatgpt/tokens.d.ts +11 -0
- package/dist/model/chatgpt/tokens.js +50 -0
- package/dist/model/connection.d.ts +6 -0
- package/dist/model/connection.js +67 -0
- package/dist/model/context-window.d.ts +3 -0
- package/dist/model/context-window.js +64 -0
- package/dist/model/context.d.ts +11 -0
- package/dist/model/context.js +69 -0
- package/dist/model/factory.d.ts +27 -0
- package/dist/model/factory.js +89 -0
- package/dist/model/fixed.d.ts +17 -0
- package/dist/model/fixed.js +41 -0
- package/dist/model/harness-profile.d.ts +6 -0
- package/dist/model/harness-profile.js +23 -0
- package/dist/model/providers.d.ts +32 -0
- package/dist/model/providers.js +72 -0
- package/dist/model/reasoning.d.ts +16 -0
- package/dist/model/reasoning.js +84 -0
- package/dist/model/record-fetch.d.ts +2 -0
- package/dist/model/record-fetch.js +19 -0
- package/dist/plugins/api.d.ts +60 -0
- package/dist/plugins/api.js +1 -0
- package/dist/plugins/manager.d.ts +35 -0
- package/dist/plugins/manager.js +280 -0
- package/dist/plugins/package.d.ts +13 -0
- package/dist/plugins/package.js +99 -0
- package/dist/plugins/registry.d.ts +8 -0
- package/dist/plugins/registry.js +14 -0
- package/dist/session/store.d.ts +93 -0
- package/dist/session/store.js +311 -0
- package/dist/session/workspace.d.ts +19 -0
- package/dist/session/workspace.js +73 -0
- package/dist/subagents/head-assignment.d.ts +11 -0
- package/dist/subagents/head-assignment.js +47 -0
- package/dist/subagents/limits.d.ts +4 -0
- package/dist/subagents/limits.js +6 -0
- package/dist/subagents/processes.d.ts +18 -0
- package/dist/subagents/processes.js +73 -0
- package/dist/subagents/request.d.ts +4 -0
- package/dist/subagents/request.js +38 -0
- package/dist/subagents/service.d.ts +73 -0
- package/dist/subagents/service.js +645 -0
- package/dist/subagents/settings.d.ts +10 -0
- package/dist/subagents/settings.js +32 -0
- package/dist/subagents/types.d.ts +63 -0
- package/dist/subagents/types.js +1 -0
- package/dist/subagents/verification.d.ts +34 -0
- package/dist/subagents/verification.js +215 -0
- package/dist/tools/browse.d.ts +13 -0
- package/dist/tools/browse.js +117 -0
- package/dist/tools/browser-capability.d.ts +3 -0
- package/dist/tools/browser-capability.js +29 -0
- package/dist/tools/diff.d.ts +6 -0
- package/dist/tools/diff.js +82 -0
- package/dist/tools/edit.d.ts +3 -0
- package/dist/tools/edit.js +152 -0
- package/dist/tools/files.d.ts +6 -0
- package/dist/tools/files.js +96 -0
- package/dist/tools/formal-input.d.ts +6 -0
- package/dist/tools/formal-input.js +29 -0
- package/dist/tools/formal.d.ts +9 -0
- package/dist/tools/formal.js +79 -0
- package/dist/tools/guard.d.ts +7 -0
- package/dist/tools/guard.js +48 -0
- package/dist/tools/job-tools.d.ts +19 -0
- package/dist/tools/job-tools.js +148 -0
- package/dist/tools/jobs.d.ts +79 -0
- package/dist/tools/jobs.js +186 -0
- package/dist/tools/language.d.ts +6 -0
- package/dist/tools/language.js +172 -0
- package/dist/tools/lean-proof.d.ts +38 -0
- package/dist/tools/lean-proof.js +83 -0
- package/dist/tools/registry.d.ts +30 -0
- package/dist/tools/registry.js +113 -0
- package/dist/tools/run.d.ts +13 -0
- package/dist/tools/run.js +163 -0
- package/dist/tools/search.d.ts +2 -0
- package/dist/tools/search.js +156 -0
- package/dist/tools/shell-process.d.ts +115 -0
- package/dist/tools/shell-process.js +297 -0
- package/dist/tools/skills.d.ts +2 -0
- package/dist/tools/skills.js +46 -0
- package/dist/tools/stateright-runtime.d.ts +3 -0
- package/dist/tools/stateright-runtime.js +16 -0
- package/dist/tools/stateright.d.ts +3 -0
- package/dist/tools/stateright.js +78 -0
- package/dist/tools/web.d.ts +24 -0
- package/dist/tools/web.js +391 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.js +2 -0
- package/docs/ci-repair-20261116.md +30 -0
- package/docs/commonlisp-build-output.md +14 -0
- package/docs/commonlisp-provider-migration.md +22 -0
- package/docs/commonlisp-qlot-recovery.md +28 -0
- package/docs/commonlisp-tls-recovery.md +28 -0
- package/docs/context-efficiency.md +122 -0
- package/docs/input.md +126 -0
- package/docs/languages.md +117 -0
- package/docs/models.md +109 -0
- package/docs/modkh-evidence.json +641 -0
- package/docs/modkh-failure-comparison.json +675 -0
- package/docs/modkh-namespace.md +39 -0
- package/docs/modkh-qlot-evidence.json +37 -0
- package/docs/modkh-verification.md +173 -0
- package/docs/modkh.md +128 -0
- package/docs/presets.md +64 -0
- package/docs/setup.md +99 -0
- package/docs/stateright.md +45 -0
- package/docs/subagents.md +152 -0
- package/docs/web.md +57 -0
- package/experiments/presets/common-lisp.lisp +38 -0
- package/experiments/presets/css.lisp +38 -0
- package/experiments/presets/formal.lisp +18 -0
- package/experiments/presets/html.lisp +38 -0
- package/experiments/presets/js.lisp +38 -0
- package/experiments/presets/language-microagents.lisp +29 -0
- package/experiments/presets/php.lisp +38 -0
- package/experiments/presets/svelte.lisp +38 -0
- package/experiments/presets/tailwindcss.lisp +24 -0
- package/experiments/presets/ts.lisp +38 -0
- package/native/stateright/Cargo.lock +478 -0
- package/native/stateright/Cargo.toml +11 -0
- package/native/stateright/src/lib.rs +163 -0
- package/native/stateright/src/main.rs +38 -0
- package/package.json +57 -4
- package/plugins/modkh-explorer/index.mjs +3 -0
- package/plugins/modkh-explorer/plugin.json +1 -0
- package/plugins/modkh-worker/index.mjs +3 -0
- package/plugins/modkh-worker/plugin.json +1 -0
- package/skills/kiokuko-dsh/LICENSE +21 -0
- package/skills/kiokuko-dsh/coding-ideal-routine-skill/SKILL.md +106 -0
- package/skills/kiokuko-dsh/japanese-translation-for-oss-models/SKILL.md +65 -0
- package/skills/kiokuko-dsh/kiokuko-architecture/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-architecture/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-benchmark/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-benchmark/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-investigate/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-investigate/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-lisp/SKILL.md +390 -0
- package/skills/kiokuko-dsh/kiokuko-review/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-review/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-simple-work/SKILL.md +70 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/SKILL.md +79 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md +52 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/domain-and-types.md +48 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/effects-and-data.md +43 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +314 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/problem-shaping-and-language.md +90 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/protocols-and-idempotency.md +42 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/review-checklist.md +92 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/verification.md +45 -0
- package/skills/kiokuko-dsh/kiokuko-skill-authoring/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-skill-authoring/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-soul/SKILL.md +25 -0
- package/skills/kiokuko-dsh/kiokuko-technical-writing/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-technical-writing/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/SKILL.md +64 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/accessibility-and-navigation.md +31 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/async-recovery.md +49 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/forms-and-controls.md +35 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/interaction-feedback.md +34 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/responsive-and-platform.md +38 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/safety-and-review.md +43 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/ui-checklist.md +75 -0
- package/skills/kiokuko-dsh/kiokuko-verification/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-verification/references/cases.md +11 -0
- package/skills/kiokuko-dsh/manifest.json +168 -0
- package/skills/kiokuko-dsh/memory-reasoning/SKILL.md +44 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/SKILL.md +113 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/boundaries-and-lifecycle.md +70 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/discovery-and-scope.md +71 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/failure-recovery.md +43 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/verification-and-completion.md +73 -0
- package/skills/kiokuko-dsh/veteran-programmer-skill/SKILL.md +66 -0
|
@@ -0,0 +1,390 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kiokuko-lisp
|
|
3
|
+
description: Compose reusable Common Lisp task tools alongside owned development tools, in disposable or persistent workers.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-lisp -->
|
|
7
|
+
|
|
8
|
+
<!-- kiokuko:runtime contract -->
|
|
9
|
+
# Common Lisp in Kiokuko DSH
|
|
10
|
+
|
|
11
|
+
## Admission and tools
|
|
12
|
+
|
|
13
|
+
Coding: use the host’s task Lisp choice independently of optional coding notes. Pending is not consent to start Lisp. Resume the saved choice. Verify the requested user entry with fresh host results.
|
|
14
|
+
Use the coding choice or `/kioku-lisp enable`; `enable-task` is disposable scratch. Schemas grant no effects; children inherit no lease, heap or refs. With Lisp ON, compose `kioku.data/workspace/tools/jobs/verify`; `kioku.process` is compatibility. Direct shells are blocked. Recover failures; only `lisp_fallback` may hand an observed unrecoverable runtime/API failure to standard tools. Stop, denial and unknown effects never authorize fallback. Never spoof host-bound session/agent/directory/generation.
|
|
15
|
+
|
|
16
|
+
Owned kioku_read/write/edit/remove/exec/result retain receipts. Routine development needs no confirmation. Declare destructiveTargets for known effects. Classification of arbitrary code is incomplete. After completion, organize memory with permission and save only the approved text.
|
|
17
|
+
|
|
18
|
+
Foreground kioku.process:run retains native Bash sandbox/approval/Stop without a memory task/Goal. Protected coding requires a prototype and result inspection. Workflows, owned tools and async jobs retain task authority. Use broker receipts. OS isolation denies direct Lisp/FFI workspace access and inherited credentials. Bind task_completion conditions/source paths before checks and collect async receipts with kioku_result. Plan permits read/search/status until approved exit.
|
|
19
|
+
|
|
20
|
+
Schemas define arguments; never guess. `lisp_describe` without a symbol gives the
|
|
21
|
+
API/verifier map, even during recovery. Persistent `lisp_eval`: declared inputs;
|
|
22
|
+
`lisp_describe`: functions; `lisp_inspect`: paged evidence; `lisp_status`: state;
|
|
23
|
+
`lisp_cancel`: stop; `lisp_recover`: restart a stopped worker after diagnosis;
|
|
24
|
+
`lisp_resume`: select one live restart on the suspended stack; `lisp_fallback`: durable
|
|
25
|
+
handoff and route switch after an unrecoverable runtime/API failure;
|
|
26
|
+
`lisp_reset`: healthy, confirmed-stopped worker only, no recovery bypass.
|
|
27
|
+
Task `lisp_define`: compiled, schema/example-checked lambda; `lisp_call`: inline input/inputRef;
|
|
28
|
+
`lisp_observe`: workspace capture without bodies; `lisp_stage`: freeze against observed
|
|
29
|
+
baseRef; `lisp_verify`: private-scratch check; `lisp_apply`: frozen-target
|
|
30
|
+
recheck; `lisp_compare`: no execution. Status/inspection read refs/receipts. Unknown
|
|
31
|
+
test status or generated `passed` fields never prove host verification.
|
|
32
|
+
|
|
33
|
+
New work: unique operationId bound to native call/host ID. Concurrent exact replay:
|
|
34
|
+
IN_PROGRESS; changed inputs: ID_CONFLICT. Transport loss: same request/ID only; never
|
|
35
|
+
replace RUNNING/UNKNOWN IDs. Results expire after 30 days; identity tombstones return
|
|
36
|
+
RESULT_EXPIRED. Lisp errors fail evaluations; timeout/broken frames/exit need human
|
|
37
|
+
recovery. Persistent reset/replacement/loss discards heap/refs; task artifacts/results
|
|
38
|
+
remain owner-bound until expiry. Never replay effects.
|
|
39
|
+
|
|
40
|
+
## Task tools and files
|
|
41
|
+
|
|
42
|
+
Common Lisp/CL-PPCRE/CL-CSV/YASON via `kioku.tools`, `kioku.data`,
|
|
43
|
+
`kioku.workspace`, `kioku.jobs`, `kioku.test`, `kioku.verify`, `kioku.session`,
|
|
44
|
+
`kioku.functions`, `kioku.files`, `kioku.process`, `kioku.objects`, `kioku.environment`, `kioku.ci`,
|
|
45
|
+
`kioku.decisions`, `kioku.typesafe`, `kioku.code`; no Quicklisp/network downloads. First enable
|
|
46
|
+
compiles; later starts reuse verified code, not session state. Compile/cache failure
|
|
47
|
+
blocks startup: report `/kioku-lisp recover`; never modify compiled files or replay effects.
|
|
48
|
+
Task mode: bounded JSON schemas, exact dependency toolRefs, no heap/worker refs
|
|
49
|
+
between calls. Disposable `lisp_eval`; workspace inputs use `lisp_observe`, never
|
|
50
|
+
legacy inputs/proposals. Expired refs never read current files; persistent mode owns shared heap.
|
|
51
|
+
|
|
52
|
+
Persistent `kioku.code`: negotiate V1 with capabilities; use with-snapshot; check status/freshness. Handles expire per evaluation. Missing V1 returns unavailable, with no tool/parser fallback. Aggregate before returning. Fixed DTOs and budgets: docs/lisp.md.
|
|
53
|
+
|
|
54
|
+
Persistent: define/test/use cohesive `defun` tools in one `lisp_eval`, reuse on new
|
|
55
|
+
inputs. Batch known work/compact evidence; split at decisions/approvals/limits. Never
|
|
56
|
+
preprogram guesses or eval data. Definitions last one generation; `lisp_describe`
|
|
57
|
+
lists `kioku.user` exports/arguments/docs. Native tool entries stay fixed.
|
|
58
|
+
|
|
59
|
+
Persistent `inputs` accepts workspace-relative or current-session upload paths.
|
|
60
|
+
Read-only copies are checked for identity, size and digest (64 MiB/file, 256 MiB/generation).
|
|
61
|
+
`(kioku.files:read-text (kioku.files:input 0))` reads the first copy. Iterate only over
|
|
62
|
+
declared inputs. Private `kioku.files:scratch` is for Lisp I/O, not native Bash writes.
|
|
63
|
+
Development processes write to authorized workspace paths; EPERM means failure. Reimport applied files for comparison. Export needs authorization.
|
|
64
|
+
`kioku.files:propose-write` uses relative paths and records successful evaluations durably.
|
|
65
|
+
Changes within the working project directory, including deletion, replacement and project DB updates, need no extra user permission. Outside-project changes require concrete confirmation. Protected compatibility mode retains frozen targets and its protected-path restrictions. Duplicate targets fail;
|
|
66
|
+
unchanged writes do nothing. Refusal/skip/UI failure/cancellation never authorizes.
|
|
67
|
+
Trust APPLIED/UNCHANGED/NOT_APPLIED/UNKNOWN receipts; partial failure stops later writes.
|
|
68
|
+
Never retry unknown effects. Use owned tools for working-project files and project DB updates; protected compatibility mode refuses its protected paths/databases/links and recursive deletion. Independent backups never auto-prune. RUNNING lasts until
|
|
69
|
+
receipts save; restart repairs finalization without reapplying effects.
|
|
70
|
+
|
|
71
|
+
## Programs, verification and packages
|
|
72
|
+
|
|
73
|
+
`kioku.process:run`/`start-job` use project-relative or absolute directories in development mode, normal PATH/environment and child processes. Use job-status/cancel-job and inspect final receipts. Explicit protected mode retains scratch-only directories, sandboxed environment and its OS child/network restrictions; never escape protection.
|
|
74
|
+
|
|
75
|
+
`kioku.ci:list-runs :limit 10`/`failed-log`: bound-repo host gh/auth, no Lisp credentials.
|
|
76
|
+
`verify`: only `:typecheck`, `:lisp`, `:test`, `:build`, `:package`, `:vendor`, never shell
|
|
77
|
+
text. Check scripts; `:script` selects existing test/test:*; absent typecheck falls
|
|
78
|
+
back to `check`. Focused then broader checks. `:directory`: workspace subproject;
|
|
79
|
+
`:location :scratch`: extracted project. Host scripts bind roots, reject links/absolute
|
|
80
|
+
paths/traversal. Profile policy covers command/args/cwd/timeout; refusal/missing UI:
|
|
81
|
+
NOT_APPLIED. Exact ID replay never reruns.
|
|
82
|
+
ok=true is not process success: check result-code/verifier state/code. Report observed
|
|
83
|
+
results; partial reads cannot prove byte equality. Separate scratch/applied-file
|
|
84
|
+
checks; validate custom checkers on known cases.
|
|
85
|
+
|
|
86
|
+
`kioku.packages` remains a bounded public npm broker: metadata (latest/exact version), audit (at most ten exact names/versions), update-lockfiles (persistent eval, one call, root npm/pnpm manifests/locks and security overrides). No arbitrary URLs, credentials, shell arguments, Local/Git dependencies or multi-project workspaces. Managers generate frozen proposals in separate network scratch; scripts/hooks and inherited config/credentials are excluded. Recheck captured inputs before returning and applying. Generation
|
|
87
|
+
approval never authorizes writes; only host changes receipts establish APPLIED/UNCHANGED. SUCCEEDED/generatedOnly is generation. Failure/refusal/cancellation returns no proposals; exact replay sends nothing. HTTP: 30s/256KiB; manager: 90s/256KiB. No retries, runtime downloads, installs, profile changes or reloads. New host APIs require plugin build/reload, not worker reset.
|
|
88
|
+
|
|
89
|
+
## Evidence, recovery and adapters
|
|
90
|
+
|
|
91
|
+
Workers persist by default. Idle suspension waits for turns/evaluations/approvals/jobs.
|
|
92
|
+
Children own their heaps, scratch and refs, deliver results natively and stop independently.
|
|
93
|
+
Failed startup blocks admission. The host controls capacity and exit. With settled
|
|
94
|
+
journals, clean exit auto-starts on admission, never status. Fault replacements: 2/owner/minute.
|
|
95
|
+
WORKER_RESUMED ran no code. Rebuild definitions, never replay effects.
|
|
96
|
+
Inspect failures, saved results, exit codes and logs. For an ordinary Lisp condition,
|
|
97
|
+
fix the helper in place, using an offered restart when applicable. After confirmed stop,
|
|
98
|
+
check `lisp_status` and inspect receipts with `lisp_inspect`/`managedOperationId`.
|
|
99
|
+
With effects settled, call `lisp_recover` with a new `operationId` and status generation
|
|
100
|
+
as `expectedGeneration` (including `null`). Recreate definitions and verify with a new ID.
|
|
101
|
+
Recovery preserves Stop, permissions and prototype limits. Inspect cancellation,
|
|
102
|
+
unknown effects, unconfirmed stops or restart limits before recovery.
|
|
103
|
+
Results: 16 KiB, no source echoes/duplicates. Page journaled evidence, never rerun/fetch
|
|
104
|
+
all history. Fix missing paths with native reads; input errors need no recovery. Report
|
|
105
|
+
observed errors/recovery; missing results never prove deletion/restoration.
|
|
106
|
+
Human `/kioku-lisp` commands: status, diagnostics [ID], cancel, recover, abandon ID,
|
|
107
|
+
restore ID, disable. Inspect UNKNOWN operations/backups before abandon (no reapply/
|
|
108
|
+
rollback). Restore crosses a new host approval boundary; diagnostics shows outcomes.
|
|
109
|
+
Disable requires confirmed stop/reconciliation; unload retains protection.
|
|
110
|
+
|
|
111
|
+
Semantic `kioku.decisions:status`/`evaluate`/`assess-relevance`/`classify-failure`/
|
|
112
|
+
`assess-change`: host-selected provider/model. Supply evidence + ordered
|
|
113
|
+
id/instructions/choices/abstainId questions, or requirement/candidates, evidence/actions,
|
|
114
|
+
requirement/before/after; candidates/actions: id/description vectors. Consume
|
|
115
|
+
`result.answers`: selected choiceId; abstained/fallback needs ordinary reasoning.
|
|
116
|
+
Cancellation stops work. No file edits or replacement of validation/tests/permissions/
|
|
117
|
+
approval; never compare provider scores.
|
|
118
|
+
|
|
119
|
+
### TypeSafe
|
|
120
|
+
|
|
121
|
+
`(kioku.typesafe:status)`; `(kioku.typesafe:evaluate state questions :model
|
|
122
|
+
"jev-latest" :timeout-ms 30000)`: JSON strings/hash tables/vectors → answers/model/usage.
|
|
123
|
+
`/kioku-typesafe-key <key>|status|clear`: visible, unrecorded credentials, never Lisp keys.
|
|
124
|
+
Batch narrow noul/choice/score over selected material, 256 KiB each way. No retry/
|
|
125
|
+
substitution; catch `kioku.typesafe:service-error` or discard proposals. Confidence ≠
|
|
126
|
+
correctness; deterministic arithmetic/permissions/tests, task-specific cutoffs.
|
|
127
|
+
Existing approvals remain authoritative. Consume a choice before inspection:
|
|
128
|
+
|
|
129
|
+
```lisp
|
|
130
|
+
(defun inspect-diagnosis (r)
|
|
131
|
+
(let ((choice (gethash "choice" (gethash "cause" (gethash "answers" r)))))
|
|
132
|
+
(cond ((equal choice "import") (kioku.files:head-lines (kioku.files:input 0)))
|
|
133
|
+
((equal choice "assertion") (kioku.files:head-lines (kioku.files:input 1)))
|
|
134
|
+
(t "Collect the failing command and full error first."))))
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
`kioku.data:read-tsv`/`write-tsv`: tables; `map-jsonl`: bounded stream; `parse-jsonl`:
|
|
138
|
+
10000 records max. UTF-8 files; bounded `kioku.files:search-text`/`diff-text`.
|
|
139
|
+
`kioku.objects:register-artifact`: immutable host copy of scratch-relative path,
|
|
140
|
+
64 MiB/file, 1000/session, 1 GiB total, no project application.
|
|
141
|
+
`kioku.tools:list/describe/call`: current schemas and pinned definitions through DSH guards;
|
|
142
|
+
stale definitions and recursive shell/Lisp calls fail. See lisp_hot_* schemas.
|
|
143
|
+
<!-- /kiokuko:runtime -->
|
|
144
|
+
|
|
145
|
+
<!-- kiokuko:runtime prototype-driven-planning -->
|
|
146
|
+
For Lisp coding, plans or reviews, settle testable doubts with current evidence or authorized target-runtime probes. Choose controls and counterexamples first; record commands, failures, observations and refs in one reasoned plan. Stop when evidence suffices or budgets expire; ask only for needed intent or authority.
|
|
147
|
+
ask_user_question/exit_plan_mode preserve ownership, cancellation and the selected execution mode.
|
|
148
|
+
|
|
149
|
+
<!-- /kiokuko:runtime -->
|
|
150
|
+
|
|
151
|
+
<!-- kiokuko:documentation examples -->
|
|
152
|
+
## Native coding preparation
|
|
153
|
+
|
|
154
|
+
Clear native implementation requests offer Lisp before model generation. A task choice is reused at Goal preparation; explicit manual session ON persists across reload. In a protected workflow, run one small relevant `lisp_eval` with `prototype: true`, then read its successful saved `operationId` using `lisp_inspect` (`resultOperationId`, `section: "result"`, complete page from zero) before implementation. Two failed attempts stop automatic retries. Once the cause is understood, direct the user to the Lisp status control’s “新しい Lisp を起動” action or `/kioku-lisp recover`. A successful recovery reopens the prototype for the same task. New requests and formal Goal scopes need fresh proof. Conversation and research are unaffected.
|
|
155
|
+
|
|
156
|
+
## Project-shared functions
|
|
157
|
+
|
|
158
|
+
Project-shared functions work in both Lisp modes without a mode switch after the
|
|
159
|
+
coding choice. The exact session/agent/repo owner reuses its resident worker, preserving
|
|
160
|
+
PID, generation and definitions. Each call uses a fresh package, object table and result scratch;
|
|
161
|
+
this is not heap security isolation. Use pure functions with explicit dependencies. Other owners
|
|
162
|
+
cannot borrow that worker. Without a resident worker, task mode uses disposable workers. `lisp_hot_contract` applies the profile approval policy to
|
|
163
|
+
schemas and 1–32 finite input/expected cases. Only the host grants approval. `lisp_hot_install` validates against that immutable contract and replaces
|
|
164
|
+
the active version only at the expected revision. Dependency code is snapshotted.
|
|
165
|
+
`lisp_hot_call` pins the active version by name; input/result refs stay owner-local.
|
|
166
|
+
`lisp_hot_status {name?}` reads heads and selected contract; `lisp_hot_deactivate`
|
|
167
|
+
uses the same profile approval policy. Approving new conditions preserves the old active
|
|
168
|
+
version until a candidate passes; old conditions cannot authorize a new install.
|
|
169
|
+
Finite cases are not a proof for every input. Active code/dependencies do not
|
|
170
|
+
expire; retired versions may be collected after 30 days. Resident shared-function requests deny host RPC.
|
|
171
|
+
Use `/kioku-lisp hot [NAME]` for human inspection. Never rerun UNKNOWN operations.
|
|
172
|
+
|
|
173
|
+
## Task-mode API details
|
|
174
|
+
|
|
175
|
+
Native tool schemas remain authoritative for exact arguments.
|
|
176
|
+
|
|
177
|
+
- `lisp_define`: `{operationId, name, description, source, inputSchema,
|
|
178
|
+
outputSchema, dependencies?: [{binding,toolRef}], examples?: [{input,expected}],
|
|
179
|
+
firstInput?}`. Source is one Lisp lambda. The host saves an immutable toolRef
|
|
180
|
+
only after compilation and declared examples pass.
|
|
181
|
+
- `lisp_call`: `{operationId, toolRef, input}` or `{operationId, toolRef, inputRef}`.
|
|
182
|
+
Select bounded `fields` with JSON pointers when the full body is unnecessary;
|
|
183
|
+
pass its resultRef to later calls without sending that body through the model.
|
|
184
|
+
- `lisp_observe`: `{operationId, paths:[workspaceRelativePath], format?:"text"|"json"}`.
|
|
185
|
+
It saves checked files as a resultRef and reports paths, digests and coverage,
|
|
186
|
+
not file bodies. Pass the ref as `lisp_call.inputRef`.
|
|
187
|
+
- `lisp_stage`: `{operationId, resultRef, baseRef}` freezes a generated proposal
|
|
188
|
+
descended from the exact observed baseRef. It does not write the workspace.
|
|
189
|
+
- `lisp_verify`: `{operationId, candidateRef, target, script?}` materializes the
|
|
190
|
+
captured bytes in private scratch and runs an approved host verifier. Observe
|
|
191
|
+
all required files, including `package.json`; missing dependencies/scripts
|
|
192
|
+
fail or return NOT_APPLIED. `testStatus:unknown` is not a passing test.
|
|
193
|
+
- `lisp_apply`: `{operationId, candidateRef, verificationRef?}` uses owned execution in development mode without extra approval for local changes; it rechecks the read set and frozen targets, and accepts only a successful
|
|
194
|
+
verification receipt for the same candidate. Without one, it reports `not-run`.
|
|
195
|
+
- `lisp_compare`: `{operationId, leftRef, rightRef}` compares saved bases and
|
|
196
|
+
operation/content hashes without executing either candidate.
|
|
197
|
+
|
|
198
|
+
The task worker recompiles saved source for each call. Global variables and
|
|
199
|
+
process RPC cannot carry heap state between calls. Development mode can invoke owned host tools; protected compatibility task workers deny host RPC. Saved resultRefs remain owner-bound
|
|
200
|
+
for up to 30 days across worker/host restart; expired refs do not read live files.
|
|
201
|
+
`lisp_status` lists recent refs and unresolved attempts; `lisp_inspect` reads
|
|
202
|
+
receipts without replay. Persistent `lisp_inspect` accepts a current-generation
|
|
203
|
+
ref or a paged saved-evidence query, never both. `lisp_cancel` needs a generation
|
|
204
|
+
in persistent mode and only an operationId in task mode.
|
|
205
|
+
|
|
206
|
+
For persistent-mode process calls, Python receives source, and Node runs with an
|
|
207
|
+
empty OpenSSL config. Use explicit `(kioku.ci:verify :test :script "test:unit")`
|
|
208
|
+
for a declared test script, or add `:location :scratch :directory "extract/project"`
|
|
209
|
+
for an extracted project.
|
|
210
|
+
|
|
211
|
+
### Provider-independent semantic decisions
|
|
212
|
+
|
|
213
|
+
Use `kioku.decisions` for applicable semantic decisions in task functions:
|
|
214
|
+
`(status)`, `(evaluate evidence questions)`, `(assess-relevance requirement candidates)`,
|
|
215
|
+
`(classify-failure evidence actions)`, `(assess-change requirement before after)`.
|
|
216
|
+
Use fully qualified names such as `kioku.decisions:assess-relevance`.
|
|
217
|
+
Candidates/actions are ordered vectors of id/description objects. Evaluate questions
|
|
218
|
+
are ordered vectors of id/instructions/choices/abstainId objects; include abstention.
|
|
219
|
+
The host selects the configured backend and snapshots its model/policy. Never choose
|
|
220
|
+
an adapter or compare provider probabilities inside domain helpers.
|
|
221
|
+
Consume `status`, then `result.answers`: selected answers carry choiceId; abstained
|
|
222
|
+
answers carry a reason. On fallback or abstention continue ordinary inspection and
|
|
223
|
+
reasoning. Cancellation remains terminal. Helpers create no filesystem/process/proposal
|
|
224
|
+
effects; selected answers never replace host validation, tests or approval.
|
|
225
|
+
|
|
226
|
+
```lisp
|
|
227
|
+
(defun applicable-candidates (requirement candidates)
|
|
228
|
+
(let ((r (kioku.decisions:assess-relevance requirement candidates)))
|
|
229
|
+
(if (equal (gethash "status" r) "completed")
|
|
230
|
+
(loop for a across (gethash "answers" (gethash "result" r))
|
|
231
|
+
when (and (equal (gethash "status" a) "selected")
|
|
232
|
+
(equal (gethash "choiceId" a) "yes"))
|
|
233
|
+
collect (gethash "id" a))
|
|
234
|
+
:inspect-with-ordinary-reasoning)))
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
## Task toolkit example
|
|
239
|
+
|
|
240
|
+
Define task-specific helpers once; reuse them with new inputs.
|
|
241
|
+
Protected mode only: edit and test the same scratch project. In development,
|
|
242
|
+
edit via `kioku.workspace` and test that workspace; never mix the two roots.
|
|
243
|
+
|
|
244
|
+
```lisp
|
|
245
|
+
(defun replace-once (text before after)
|
|
246
|
+
"Replace exactly one nonempty literal; reject absent or ambiguous matches."
|
|
247
|
+
(when (zerop (length before)) (error "EMPTY_MATCH"))
|
|
248
|
+
(let ((at (search before text)))
|
|
249
|
+
(unless at (error "MATCH_MISSING"))
|
|
250
|
+
(when (search before text :start2 (1+ at)) (error "MATCH_AMBIGUOUS"))
|
|
251
|
+
(concatenate 'string (subseq text 0 at) after
|
|
252
|
+
(subseq text (+ at (length before))))))
|
|
253
|
+
|
|
254
|
+
(defun check-project (directory)
|
|
255
|
+
"Return the protected scratch project's process exit code, stdout and stderr."
|
|
256
|
+
(unless (equal (gethash "executionMode" (kioku.environment:status)) "protected")
|
|
257
|
+
(error "PROTECTED_SCRATCH_EXAMPLE_ONLY"))
|
|
258
|
+
(kioku.process:run "node"
|
|
259
|
+
'("--test" "--experimental-test-isolation=none" "test/public.test.mjs")
|
|
260
|
+
:directory directory))
|
|
261
|
+
|
|
262
|
+
(defun repair-and-check (directory file before after)
|
|
263
|
+
"Edit one matched scratch file and check it; failed tests leave the edit visible."
|
|
264
|
+
(unless (equal (gethash "executionMode" (kioku.environment:status)) "protected")
|
|
265
|
+
(error "PROTECTED_SCRATCH_EXAMPLE_ONLY"))
|
|
266
|
+
(let ((paths (kioku.files:glob-scratch
|
|
267
|
+
(concatenate 'string directory "/" file) :limit 2)))
|
|
268
|
+
(unless (= 1 (length paths)) (error "EXPECTED_ONE_FILE"))
|
|
269
|
+
(let* ((path (aref paths 0))
|
|
270
|
+
(source (kioku.files:read-text path))
|
|
271
|
+
(updated (replace-once source before after)))
|
|
272
|
+
(kioku.files:write-text path updated)
|
|
273
|
+
(let ((result (check-project directory)))
|
|
274
|
+
(setf (gethash "changedFile" result) path)
|
|
275
|
+
result))))
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
Call it with a new operation ID (definitions and the first call may share one eval):
|
|
279
|
+
|
|
280
|
+
```lisp
|
|
281
|
+
(repair-and-check "project" "src/index.mjs"
|
|
282
|
+
"export const value = 0;" "export const value = 42;")
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
Inspect `code`/`stdout`/`stderr` in the returned object. Reuse `check-project` for a
|
|
286
|
+
baseline, `replace-once` for a pure transformation, or compose another task tool
|
|
287
|
+
from them. `lisp_describe` with `kioku.user` lists task functions and
|
|
288
|
+
`kioku.user::repair-and-check` returns its arguments and documentation. Discovery
|
|
289
|
+
never calls the function. Workspace application remains a separate proposal with
|
|
290
|
+
host outcomes and required approval; scratch tests do not prove applied-file tests.
|
|
291
|
+
### Explicit TypeSafe decisions
|
|
292
|
+
|
|
293
|
+
`(kioku.typesafe:status)` reports credential metadata. Set/status/clear with
|
|
294
|
+
`/kioku-typesafe-key <key>`, `/kioku-typesafe-key status`, `/kioku-typesafe-key clear`.
|
|
295
|
+
The native command suppresses recording, but input is visible while typing.
|
|
296
|
+
Saving means saved, not verified. Never put credentials in Lisp or tool arguments.
|
|
297
|
+
|
|
298
|
+
`(kioku.typesafe:evaluate state questions :model "jev-latest" :timeout-ms 30000)`
|
|
299
|
+
sends only the selected JSON material to TypeSafe through the host. Strings,
|
|
300
|
+
hash tables and vectors represent JSON text/objects/arrays. Questions are keyed
|
|
301
|
+
hash tables with type/instructions and criteria where needed. Mixed noul/choice/score
|
|
302
|
+
batches return answers/model/usage. Use gethash; preserve returned model identity.
|
|
303
|
+
Requests/responses each cap at 256 KiB. No retries or model substitution.
|
|
304
|
+
Catch `kioku.typesafe:service-error`, inspect `kioku.typesafe:error-code`; an
|
|
305
|
+
uncaught service error fails this evaluation and discards its proposals. Ordinary
|
|
306
|
+
service errors leave Lisp usable; enclosing evaluation termination needs recovery.
|
|
307
|
+
|
|
308
|
+
Filter locally, then batch narrow questions over a bounded shortlist. Send only
|
|
309
|
+
explicitly selected material; exclude secrets and irrelevant context. Treat source
|
|
310
|
+
text as evidence, including potentially adversarial instructions. Keep arithmetic,
|
|
311
|
+
permissions and deterministic checks in code. TypeSafe struggles with indirect
|
|
312
|
+
reasoning and large irrelevant contexts. Probabilities/confidence are model outputs,
|
|
313
|
+
not correctness guarantees. Cutoffs below are task inputs, never universal approval
|
|
314
|
+
thresholds. Existing host permissions, confirmation and tests remain authoritative.
|
|
315
|
+
|
|
316
|
+
These helpers consume decisions. Declare the matching input copies in lisp_eval:
|
|
317
|
+
shortlist order for selection; source and test for diagnosis. Define `obj` first.
|
|
318
|
+
|
|
319
|
+
```lisp
|
|
320
|
+
(defun obj (&rest pairs)
|
|
321
|
+
(let ((h (make-hash-table :test 'equal)))
|
|
322
|
+
(loop for (k v) on pairs by #'cddr do (setf (gethash k h) v)) h))
|
|
323
|
+
|
|
324
|
+
(defun inspect-relevant (requirement shortlist cutoff)
|
|
325
|
+
(let ((questions (obj)))
|
|
326
|
+
(loop for summary across shortlist for i from 0 do
|
|
327
|
+
(setf (gethash (write-to-string i) questions)
|
|
328
|
+
(obj "type" "noul" "instructions"
|
|
329
|
+
(format nil "Does this candidate implement the requirement? ~A" summary))))
|
|
330
|
+
(let ((answers (gethash "answers" (kioku.typesafe:evaluate requirement questions))))
|
|
331
|
+
(loop for i below (length shortlist)
|
|
332
|
+
when (>= (gethash "noul" (gethash (write-to-string i) answers)) cutoff)
|
|
333
|
+
collect (kioku.files:read-text (kioku.files:input i))))))
|
|
334
|
+
|
|
335
|
+
(defun inspect-failure (evidence)
|
|
336
|
+
(let* ((r (kioku.typesafe:evaluate evidence
|
|
337
|
+
(obj "cause" (obj "type" "choice" "instructions" "Classify the observed failure."
|
|
338
|
+
"criteria" (obj "import" "Module resolution failure"
|
|
339
|
+
"assertion" "An executed assertion failed" "insufficient" "Evidence cannot distinguish causes")))))
|
|
340
|
+
(choice (gethash "choice" (gethash "cause" (gethash "answers" r)))))
|
|
341
|
+
(cond ((equal choice "import") (kioku.files:head-lines (kioku.files:input 0)))
|
|
342
|
+
((equal choice "assertion") (kioku.files:head-lines (kioku.files:input 1)))
|
|
343
|
+
(t "Collect the failing command and complete error before choosing a fix."))))
|
|
344
|
+
|
|
345
|
+
(defun consider-change (requirement before after path minimum-fit maximum-unrelated)
|
|
346
|
+
(let* ((r (kioku.typesafe:evaluate (obj "requirement" requirement "before" before "after" after)
|
|
347
|
+
(obj "fit" (obj "type" "noul" "instructions" "Does the change satisfy the requirement?")
|
|
348
|
+
"unrelated" (obj "type" "noul" "instructions" "Does the change introduce behavior unrelated to the requirement?"))))
|
|
349
|
+
(answers (gethash "answers" r)))
|
|
350
|
+
(if (and (>= (gethash "noul" (gethash "fit" answers)) minimum-fit)
|
|
351
|
+
(<= (gethash "noul" (gethash "unrelated" answers)) maximum-unrelated))
|
|
352
|
+
(kioku.files:propose-write path after)
|
|
353
|
+
"Inspect the requirement and diff further before proposing.")))
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
<!-- /kiokuko:documentation -->
|
|
357
|
+
|
|
358
|
+
<!-- kiokuko:documentation approval-help -->
|
|
359
|
+
## Development approval policy
|
|
360
|
+
|
|
361
|
+
Project edits, verification, helper compilation/registration and ordinary Kioku storage are authorized. Changes within the working project directory, including deletion, replacement and project DB updates, need no extra user permission. Outside-project changes require concrete confirmation. Legacy lisp.approvalMode ask/auto does not add confirmation for local files. Old profile settings still load. Do not request conversational permission before a required host review. Refusal, cancellation, stale targets and uncertain outcomes remain authoritative; never replay effects.
|
|
362
|
+
|
|
363
|
+
<!-- /kiokuko:documentation -->
|
|
364
|
+
<!-- kiokuko:runtime approval-policy -->
|
|
365
|
+
Routine development and helper registration are authorized. Lisp failure retains the selected shell route. Report execution, verification and saving separately; retry saving without replaying effects.
|
|
366
|
+
<!-- /kiokuko:runtime -->
|
|
367
|
+
|
|
368
|
+
|
|
369
|
+
<!-- kiokuko:documentation code-intelligence -->
|
|
370
|
+
## Read-only code intelligence
|
|
371
|
+
|
|
372
|
+
Persistent evaluations may use `kioku.code` when the calling agent has a V1
|
|
373
|
+
provider. Call `capabilities` first; absence/old version returns `unavailable`.
|
|
374
|
+
There is no generic LSP/tool/parser fallback. Task workers cannot use host RPC.
|
|
375
|
+
Use `with-snapshot` around `open`/`outline`/`enclosing`/fixed `query`/`span`/read-only
|
|
376
|
+
`semantic`; it releases accepted snapshots with `unwind-protect`. Check `status`
|
|
377
|
+
before `data`: preserve partial, unsupported, unavailable, stale, cancelled,
|
|
378
|
+
timeout and limit-exceeded results. Unready diagnostics are not clean diagnostics.
|
|
379
|
+
Queries are only `declarations`, `calls`, `imports`; semantic kinds are definition,
|
|
380
|
+
references, implementation, hover, diagnostics, completion. Never request writes,
|
|
381
|
+
rename, commands, arbitrary query text, or arbitrary RPC.
|
|
382
|
+
Aggregate/filter in Lisp and return counts plus chosen spans and outcome metadata.
|
|
383
|
+
Do not return an entire large corpus just because the worker can hold it. Positions
|
|
384
|
+
are zero-based UTF-16; ranges half-open; snapshots are disk-only. Reopen after a
|
|
385
|
+
file/checkout change. Handles expire at evaluation end and saved results are not
|
|
386
|
+
live authority. Keep 100 calls, 16 MiB input, 64 KiB responses, 30 seconds per code
|
|
387
|
+
batch; per response 32 KiB, document 2 MiB, captures 200, outline 100, span 8000.
|
|
388
|
+
Release stays available after limits. Check `lisp_describe` for exact arguments.
|
|
389
|
+
|
|
390
|
+
<!-- /kiokuko:documentation -->
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kiokuko-review
|
|
3
|
+
description: Review a diff, assess blast radius, or challenge code with concrete counterexamples.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-review -->
|
|
7
|
+
|
|
8
|
+
<!-- kiokuko:runtime contract -->
|
|
9
|
+
# Review
|
|
10
|
+
|
|
11
|
+
Follow SOUL and the current host directive. This skill grants no extra permissions, model changes or delegation. Use the current model and proportionate evidence.
|
|
12
|
+
|
|
13
|
+
Identify the exact diff and intended behavior. Trace changed producers through consumers, failure paths and shared state. Try a concrete counterexample to each material correctness claim. Preserve useful rationale, legal notices and constraint comments; uncertainty is a reason to investigate, not delete. Review alone does not authorize edits.
|
|
14
|
+
|
|
15
|
+
## Completion
|
|
16
|
+
|
|
17
|
+
Report location, trigger, consequence and evidence for each defect. Separate defects from optional style suggestions. Deduplicate findings. Passing builds and reviewer agreement are not behavioral proof. State unverified paths and missing coverage.
|
|
18
|
+
|
|
19
|
+
Read [worked cases](references/cases.md) only when the decision or failure boundary is unclear. Do not load unrelated specialists or repeat completed checks without new evidence.
|
|
20
|
+
<!-- /kiokuko:runtime -->
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-review -->
|
|
2
|
+
|
|
3
|
+
# Decision example
|
|
4
|
+
|
|
5
|
+
A comment warns that a callback runs after disposal.
|
|
6
|
+
|
|
7
|
+
Trace registration and cleanup, reproduce a late callback if possible. Keep the warning until the constraint is disproved or structurally enforced; deleting it is not a fix.
|
|
8
|
+
|
|
9
|
+
## Non-trigger
|
|
10
|
+
|
|
11
|
+
A mechanical edit with known behavior uses the existing simple-work and code contracts. Do not turn it into a panel, benchmark or architecture exercise.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kiokuko-simple-work
|
|
3
|
+
description: Use for bounded, low-risk coding work with a clear target, or when the user asks for the simplest, minimal, YAGNI, or dependency-free solution.
|
|
4
|
+
license: MIT
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-simple-work -->
|
|
8
|
+
|
|
9
|
+
<!-- kiokuko:runtime contract -->
|
|
10
|
+
# Kiokuko Simple Work
|
|
11
|
+
|
|
12
|
+
Build the smallest solution that fully works. The best code is the code never written.
|
|
13
|
+
|
|
14
|
+
## Persistence
|
|
15
|
+
|
|
16
|
+
Active for the current logical user request only; re-evaluate through `kiokuko-soul` for every new one. Default intensity is **full**, and "lite" or "ultra" adjust it within the same request only — the level never carries into a new logical request.
|
|
17
|
+
|
|
18
|
+
## The ladder
|
|
19
|
+
|
|
20
|
+
Stop at the first rung that holds:
|
|
21
|
+
|
|
22
|
+
1. **Does this need to exist at all?** Speculative need → skip it and say so in one line.
|
|
23
|
+
2. **Already in this codebase?** Reuse the helper, util, type, or pattern that already lives here. Re-implementing what sits a few files over is the most common slop.
|
|
24
|
+
3. **Stdlib does it?** Use it.
|
|
25
|
+
4. **Native platform feature covers it?** `<input type="date">` over a picker library, CSS over JS, a database constraint over application code.
|
|
26
|
+
5. **An already-installed dependency solves it?** Use it; never add a new one for what a few lines can do.
|
|
27
|
+
6. **Can the flow be clearer?** Prefer named concepts and cohesive operations over compressed expressions.
|
|
28
|
+
7. **Only then:** the minimum code that works.
|
|
29
|
+
|
|
30
|
+
The ladder runs after understanding the problem: trace the real flow, then choose the simplest cohesive solution that satisfies behavior, required implementation method, compatibility and verification. Passing tests alone does not establish those conditions.
|
|
31
|
+
|
|
32
|
+
**A bug fix targets the root cause, not the symptom.** A report names a symptom. Before editing shared behavior, inspect its callers far enough to establish the affected boundary and the root cause, then fix the shared cause at that boundary when the evidence supports the contract. Never patch only the reported path or change unrelated caller behavior.
|
|
33
|
+
|
|
34
|
+
## Rules
|
|
35
|
+
|
|
36
|
+
- No unrequested abstractions, boilerplate, or scaffolding "for later": no interface with one implementation, no factory for one product, no config for a value that never changes.
|
|
37
|
+
- Deletion over addition. Boring over clever.
|
|
38
|
+
- Minimize unnecessary work, not file count or line count. Keep readable responsibility and ownership boundaries.
|
|
39
|
+
- Complex request? Complete the requested behavior and method. If a simplification omits a requirement, explain the constraint and obtain a scope decision before substituting it. Resolve routine choices from current evidence.
|
|
40
|
+
- Two stdlib options of the same size? Take the one that is correct on edge cases. Lazy means less code, not the flimsier algorithm.
|
|
41
|
+
- Mark a deliberate simplification that cuts a real corner with a known ceiling (global lock, O(n²) scan, naive heuristic) using a comment that names the ceiling and the upgrade path: `# ponytail: global lock, per-account locks if throughput matters`.
|
|
42
|
+
|
|
43
|
+
## Output
|
|
44
|
+
|
|
45
|
+
Report changed behavior, verification evidence and remaining uncertainty proportionally. Brevity must not hide omissions or blockers; no fixed output-length quota.
|
|
46
|
+
|
|
47
|
+
Pattern: `[code] → skipped: [X], add when [Y].`
|
|
48
|
+
|
|
49
|
+
Intensity: **lite** applies the ladder locally; **full** checks reuse and unnecessary work across the changed flow; **ultra** also challenges speculative abstractions and retention. Every mode preserves explicit requirements, readability, error handling and required verification.
|
|
50
|
+
|
|
51
|
+
## When not to be lazy
|
|
52
|
+
|
|
53
|
+
Never simplify away input validation at trust boundaries, error handling that prevents data loss, security measures, accessibility basics, or anything explicitly requested. If the user insists on the full version, build it without re-arguing.
|
|
54
|
+
|
|
55
|
+
Never be lazy about understanding the problem. Trace the relevant execution flow end to end before picking a rung, and read enough to establish the changed contract, its affected boundaries, and the root cause; expand the investigation when evidence exposes another relevant path. A small diff does not excuse an unverified understanding.
|
|
56
|
+
|
|
57
|
+
Leave the calibration knob in hardware work: a real clock drifts and a real sensor reads off, so the physical world needs tuning a minimal model cannot see.
|
|
58
|
+
|
|
59
|
+
Lazy code without its check is unfinished. Non-trivial logic — a branch, a loop, a parser, a money or security path — leaves ONE runnable check behind, the smallest thing that fails if the logic breaks, using the target project's existing test placement, runner, and commands. Do not introduce a new framework, fixture layer, or test convention. Trivial one-liners need no test; YAGNI applies to tests too.
|
|
60
|
+
|
|
61
|
+
## Boundaries
|
|
62
|
+
|
|
63
|
+
Ponytail governs what you build, not how you talk. "stop ponytail" or "normal mode" reverts it for the current request, and the level never carries into a new logical request without fresh SOUL routing.
|
|
64
|
+
|
|
65
|
+
Completion requires the requested result and matching evidence.
|
|
66
|
+
|
|
67
|
+
## Focused engineering practice
|
|
68
|
+
|
|
69
|
+
Delete only demonstrated redundancy. Minimize reader load without splitting cohesive operations into one-caller wrappers. A tool or codemod must save enough repeated work to justify its setup.
|
|
70
|
+
<!-- /kiokuko:runtime -->
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kiokuko-single-purpose-functions
|
|
3
|
+
description: Use for any code work — writing, changing, reviewing, or debugging. Apply the function contract, then read only the expert fragments the change's actual risks select.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-single-purpose-functions -->
|
|
7
|
+
|
|
8
|
+
<!-- kiokuko:runtime contract -->
|
|
9
|
+
# Single-purpose function router
|
|
10
|
+
|
|
11
|
+
## Outcome
|
|
12
|
+
|
|
13
|
+
Create code whose functions each own one cohesive, externally observable responsibility, with explicit concepts, representation boundaries, effects, failures, and focused verification — in any language, framework, or repository.
|
|
14
|
+
|
|
15
|
+
This index is the execution envelope for code work. Read it completely, select the smallest sufficient expert set, then read only those expert files.
|
|
16
|
+
|
|
17
|
+
## Credo
|
|
18
|
+
|
|
19
|
+
**本当に、それを全部計算・保存・検索する必要があるのか?**
|
|
20
|
+
|
|
21
|
+
Before decomposing a function, justify its work. Compute only required outputs; justify stored data by its consumer and retention need; bound searches to needed evidence. Consider on-demand or incremental work before full recomputation. Preserve the contract, ownership and required checks; fewer functions alone do not mean less work.
|
|
22
|
+
|
|
23
|
+
## Universal core
|
|
24
|
+
|
|
25
|
+
Applies to every created or changed function:
|
|
26
|
+
|
|
27
|
+
1. State one contract: input, success, expected failures, effects, observable result.
|
|
28
|
+
2. Name the user-visible or domain concept, its input and output, and what must stay private before choosing a storage, framework, transport, or UI representation. Keep this proportional; a representation-preserving mechanical change needs no separate design artifact.
|
|
29
|
+
3. One responsibility, one reason to change. No meaningless micro-functions.
|
|
30
|
+
4. Validate hostile input at the boundary; keep the private core constrained by types or validated values.
|
|
31
|
+
5. Do not mutate caller-owned input unless mutation is the explicit API contract.
|
|
32
|
+
6. Keep domain decisions deterministic; make persistence, network, filesystem, process, clock, randomness, UI, and logging effects explicit.
|
|
33
|
+
7. Return or throw failures intentionally. Never swallow, partially succeed, or leak a lower-layer accident as the public contract.
|
|
34
|
+
8. Verify changed behavior with the smallest meaningful runnable check. Add or modify a test when it protects a material behavior, failure boundary, or regression, reuse existing coverage when that suffices, and skip implementation-mirroring tests for trivial, reversible, low-impact changes.
|
|
35
|
+
9. Preserve unrelated code and existing public behavior unless the task explicitly changes it.
|
|
36
|
+
|
|
37
|
+
Cohesion is the objective, not smallness. Keep operations together when splitting them would hide sequencing, duplicate policy, or weaken a transaction.
|
|
38
|
+
|
|
39
|
+
Prefer clear names, dependency direction and ownership over line/file quotas.
|
|
40
|
+
Avoid compressed flow, duplicate wrappers and speculative abstractions. For a
|
|
41
|
+
non-trivial design, identify one nearby extension/recovery, its affected parts
|
|
42
|
+
and preserved contracts; do not build it speculatively. Cite code in reviews;
|
|
43
|
+
no extra design document is required.
|
|
44
|
+
|
|
45
|
+
When a change spans setup, delivery, persisted state, or runtime handoffs, also
|
|
46
|
+
apply the available `veteran-programmer-skill` before and after implementation
|
|
47
|
+
to check the complete workflow. An isolated edit needs no additional audit.
|
|
48
|
+
|
|
49
|
+
## Expert selection
|
|
50
|
+
|
|
51
|
+
For each new or materially changed function, or for the smallest WorkUnit owning one cohesive use case: classify the dominant risk, select one expert below, add at most two more only when the same contract genuinely crosses those risks, record a concrete reason for each, and read the selected files before implementation or review. A different expert set or reason to change means a separate WorkUnit or a separate function contract inside it.
|
|
52
|
+
|
|
53
|
+
Code changes select `code.*` expertise; interactive UI changes also select `ui.*`. Tests, documentation and operations select expertise for their actual risks. Keep the mapping in the working plan or review notes:
|
|
54
|
+
|
|
55
|
+
```text
|
|
56
|
+
target -> responsibility -> expert IDs -> focused verifier
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Do not load unselected fragments “just in case.” If repository evidence exposes a new risk, update the selection explicitly before consuming that fragment.
|
|
60
|
+
|
|
61
|
+
## Expert index
|
|
62
|
+
|
|
63
|
+
| Expert ID | Select when the contract owns | Read |
|
|
64
|
+
| --- | --- | --- |
|
|
65
|
+
| `code.boundary.v1` | parsing, validation, authorization, ownership, untrusted input | [boundaries-and-ownership.md](references/boundaries-and-ownership.md) |
|
|
66
|
+
| `code.domain.v1` | domain rules, state transitions, narrow types, deterministic decisions | [domain-and-types.md](references/domain-and-types.md) |
|
|
67
|
+
| `code.effects.v1` | database, filesystem, network, process, transaction, resource lifetime | [effects-and-data.md](references/effects-and-data.md) |
|
|
68
|
+
| `code.protocol.v1` | retry, idempotency, concurrency, revisions, external/public protocols | [protocols-and-idempotency.md](references/protocols-and-idempotency.md) |
|
|
69
|
+
| `code.verification.v1` | regression repair, test design, review, compatibility or failure evidence | [verification.md](references/verification.md) |
|
|
70
|
+
| `code.modeling.v1` | problem shaping, public data design, domain vocabulary, or translation between storage, API, serialization, and UI representations | [problem-shaping-and-language.md](references/problem-shaping-and-language.md) |
|
|
71
|
+
|
|
72
|
+
## Escalation references
|
|
73
|
+
|
|
74
|
+
Read [kiokuko-patterns.md](references/kiokuko-patterns.md) only when a selected fragment needs a fuller example. Read [review-checklist.md](references/review-checklist.md) for comprehensive review or final verification — a change crossing several code contracts, or the last check before accepting — not for an ordinary edit inside one cohesive contract, which uses the focused `verification.md` sequence.
|
|
75
|
+
|
|
76
|
+
## Completion report
|
|
77
|
+
|
|
78
|
+
Report the function or WorkUnit contracts changed, the selected expert IDs, the focused verifier results, and anything left unverified. A build alone does not prove boundary, failure, or interaction behavior.
|
|
79
|
+
<!-- /kiokuko:runtime -->
|
package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-single-purpose-functions -->
|
|
2
|
+
|
|
3
|
+
# `code.boundary.v1` — boundaries and ownership
|
|
4
|
+
|
|
5
|
+
Select this expert when a function receives data or authority from a caller, user, file, database, environment, network, parser, plugin, or another process.
|
|
6
|
+
|
|
7
|
+
## Contract
|
|
8
|
+
|
|
9
|
+
The public boundary accepts broad input only long enough to validate and normalize it into a narrow internal value. Reject malformed, ambiguous, oversized, unauthorized, or out-of-scope input before domain work or effects begin.
|
|
10
|
+
|
|
11
|
+
Define explicitly:
|
|
12
|
+
|
|
13
|
+
- what input representations are accepted;
|
|
14
|
+
- whether normalization changes identity or only representation;
|
|
15
|
+
- which limits prevent resource abuse;
|
|
16
|
+
- which caller or principal is authorized;
|
|
17
|
+
- which errors are public and stable;
|
|
18
|
+
- who owns mutable collections, buffers, streams, or objects after the call.
|
|
19
|
+
|
|
20
|
+
Validation must match the actual threat boundary. A TypeScript type annotation does not validate JSON. A UI constraint does not validate an HTTP request. A prior parser does not authorize the current operation.
|
|
21
|
+
|
|
22
|
+
## Ownership rules
|
|
23
|
+
|
|
24
|
+
- Treat caller-owned inputs as immutable by default. Copy before sorting, filtering in place, deleting keys, or retaining a mutable reference.
|
|
25
|
+
- Do not return internal mutable state directly when callers could corrupt invariants.
|
|
26
|
+
- Make transfer of ownership explicit for streams, handles, transactions, and buffers.
|
|
27
|
+
- Avoid aliases where one layer can mutate data another layer assumes is stable.
|
|
28
|
+
- Preserve original user data through validation failures unless destructive normalization is the explicit contract.
|
|
29
|
+
|
|
30
|
+
## Boundary shape
|
|
31
|
+
|
|
32
|
+
The schema example below assumes input was decoded or safely normalized into an owned, bounded data-only representation. A schema alone does not reject arbitrary in-process Proxy/accessor behavior without invoking it; use the established normalization boundary first. Do not duplicate that defense in trusted internal calls.
|
|
33
|
+
|
|
34
|
+
Prefer a thin public function that performs hostile-boundary work and then calls a constrained private core:
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
function parseCreateRequest(input: unknown): CreateRequest {
|
|
38
|
+
const parsed = createRequestSchema.safeParse(input);
|
|
39
|
+
if (!parsed.success) throw new PublicError('invalid_request');
|
|
40
|
+
return parsed.data;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function decideCreate(request: CreateRequest): CreateDecision {
|
|
44
|
+
// No unknown input remains here.
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Do not scatter the same validation across several deeper functions. Centralize public error mapping so transport, database, or parser details do not accidentally become the API.
|
|
49
|
+
|
|
50
|
+
## Focused verification
|
|
51
|
+
|
|
52
|
+
Test at least one valid input, each materially different rejection class, caller-input immutability, and the absence of effects after rejection. For authorization boundaries, include a counterexample that has valid shape but insufficient authority.
|