docs: rename docs/ -> serverAppConfigs-docs/ per system-wide PROJECTNAME-docs convention
All in-repo path references (AGENTS.md, README, old scripts, report artifacts,
test code paths) rewritten in the same commit; focused-test map extended for
.gitignore, old/scripts/*, dankclaw/comfyui/*, and report/* per this repo's
own convention ('add one before committing'). Obsidian wikilinks are
title-based and unaffected.
This commit is contained in:
1 parent
6d4a96a423
commit
5829a0bfe8
140 files changed
+1820
-86
No files matched your search
@@ -41,7 +41,7 @@ Dankserver switched from ik_llama.cpp Ornith CRACK Q8_0 to stock llama.cpp
|
||||
Tiel-Coder-35B (qwen35moe hybrid MoE), and Dankclaw switched from the Q6_0
|
||||
AGENT model to the Flash-Next 56B MoE (qwen4exp, PR #27742 merged into
|
||||
charlie's ROCmFPX fork, --fit off, 128k context). Runbooks:
|
||||
[docs/LLM/index.md](docs/LLM/index.md).
|
||||
[serverAppConfigs-docs/LLM/index.md](serverAppConfigs-docs/LLM/index.md).
|
||||
Retired scripts live in `old/` (reference only) and `.AGENTTRASH/`.
|
||||
|
||||
## Repository Layout
|
||||
@@ -53,30 +53,30 @@ Retired scripts live in `old/` (reference only) and `.AGENTTRASH/`.
|
||||
(service-scoped deployer), LLM serve scripts, systemd units, env tunables,
|
||||
and bench harnesses
|
||||
- `old/` — retired PP/NPU-era LLM scripts (reference only)
|
||||
- `docs/` — knowledge base (Obsidian vault). `docs/LLM/` is the LLM fleet
|
||||
- `serverAppConfigs-docs/` — knowledge base (Obsidian vault). `serverAppConfigs-docs/LLM/` is the LLM fleet
|
||||
- `tests/` — bats test suite
|
||||
|
||||
## Documentation Authoring
|
||||
|
||||
The `docs/` vault is the project knowledge base (Obsidian, wikilinks) and is an
|
||||
The `serverAppConfigs-docs/` vault is the project knowledge base (Obsidian, wikilinks) and is an
|
||||
OKF (Open Knowledge Format) knowledge bundle. Follow the OKF spec for every doc
|
||||
you create or edit.
|
||||
|
||||
- **Canonical spec:** `~/.pi/agent/docs/references/okf-spec.md` — the OKF v0.1
|
||||
spec in the **system-config knowledge base** at `~/.pi/agent/docs`. The repo's
|
||||
own `docs/references/okf-spec.md` is deprecated/removed; use the system one. The
|
||||
own `serverAppConfigs-docs/references/okf-spec.md` is deprecated/removed; use the system one. The
|
||||
spec index and maintenance guide are
|
||||
`~/.pi/agent/docs/references/index.md` and
|
||||
`~/.pi/agent/docs/references/okf-maintenance.md`.
|
||||
- **Read before you touch:** open the relevant `index.md` first
|
||||
(`docs/index.md` → `docs/LLM/index.md`). Read the whole target file before
|
||||
(`serverAppConfigs-docs/index.md` → `serverAppConfigs-docs/LLM/index.md`). Read the whole target file before
|
||||
editing it.
|
||||
- **One concept per file**, with YAML frontmatter that has a non-empty `type:`
|
||||
field (`reference` / `guide` / `configuration` / `research`) plus `description`,
|
||||
`tags`, and `timestamp`. Split broad topics; keep pages ~1–500 lines.
|
||||
- **Progressive disclosure:** an `index.md` at each level links its children.
|
||||
Every `docs/**/*.md` (except `index.md`) must be linked from
|
||||
`docs/index.md` with `[[Title]]` — the docs-completeness test checks this.
|
||||
Every `serverAppConfigs-docs/**/*.md` (except `index.md`) must be linked from
|
||||
`serverAppConfigs-docs/index.md` with `[[Title]]` — the docs-completeness test checks this.
|
||||
- **Cross-link** siblings as `[[Title]]` wikilinks; cite external claims under a
|
||||
`# Citations` section.
|
||||
- **Always update docs** when a task changes behavior, then run
|
||||
@@ -183,7 +183,7 @@ Test seams: compose validity, env consistency (no leaked secrets), Caddyfile
|
||||
validity, quadlet units, docs completeness, script syntax (all of `scripts/`,
|
||||
including the LLM serve scripts), LLM unit integrity (units point at files in
|
||||
this repo), LLM secret hygiene, deployment flow, and service-scoped deployment
|
||||
planning/dispatch. See [docs/Architecture/Testing Policy.md](docs/Architecture/Testing%20Policy.md).
|
||||
planning/dispatch. See [serverAppConfigs-docs/Architecture/Testing Policy.md](serverAppConfigs-docs/Architecture/Testing%20Policy.md).
|
||||
|
||||
## Secret Rules
|
||||
|
||||
@@ -293,7 +293,7 @@ on qwen4exp hyper-connection config), and reasoning on (Sharp template, budget
|
||||
**Serving status (2026-09-01):** deployed the Flash-Next 56B MoE model. The
|
||||
previous kingjones Q6_0 AGENT model (27B, standalone MTP, 262144 context) is
|
||||
retired. The Q8_0 AGENT experiment is documented in
|
||||
`docs/LLM/kingjones-q8agent-rocmfpx.md`; it was retired because it crashed in
|
||||
`serverAppConfigs-docs/LLM/kingjones-q8agent-rocmfpx.md`; it was retired because it crashed in
|
||||
`ggml_compute_forward_set_rows` and did not provide a working service.
|
||||
|
||||
### Tiel-Coder-35B-A3B llama.cpp (Dankserver, ACTIVE)
|
||||
@@ -325,7 +325,7 @@ ubatch bench on 8k context), f16 KV, full 262144 context / 1 slot, TEMPERATURE
|
||||
0.7 / TOP_P 0.95, reasoning on (deepseek, budget -1), `--no-mmap`. Two-file
|
||||
payload (~14.4 GiB) in `/home/dank/models/eemin-Qwen3.8-27B-ROCMI4-MTP/`. Full
|
||||
runbook:
|
||||
[docs/LLM/eemin-rocmi4-mtp.md](docs/LLM/eemin-rocmi4-mtp.md).
|
||||
[serverAppConfigs-docs/LLM/eemin-rocmi4-mtp.md](serverAppConfigs-docs/LLM/eemin-rocmi4-mtp.md).
|
||||
|
||||
|
||||
### Kairic Edge llama.cpp (Dankclaw, RETIRED experiment 2026-08-22)
|
||||
@@ -339,7 +339,7 @@ verification shapes through the RDNA 3.5 native IU4 matrix instruction.
|
||||
`config.h.in`. The release script and guide never generate
|
||||
`third_party/composable_kernel/include/ck/config.h`. Generate it via a CK
|
||||
CMake configure and copy it in before building (full runbook in
|
||||
[docs/LLM/kairic-edge.md](docs/LLM/kairic-edge.md)). The file is untracked
|
||||
[serverAppConfigs-docs/LLM/kairic-edge.md](serverAppConfigs-docs/LLM/kairic-edge.md)). The file is untracked
|
||||
in CK git. A `git clean` removes it. Local rebuilds are byte-identical
|
||||
(`d7625a0c...`).
|
||||
|
||||
@@ -360,7 +360,7 @@ Restored to v3 on 2026-08-22 (commit `c60156f`).
|
||||
A DFlash2 Vulkan deployment briefly replaced CIRU on 2026-08-21, then was
|
||||
reverted the same day for speed. Its serve script, env, and the build
|
||||
worktree are archived in `.AGENTTRASH/` and documented in
|
||||
[docs/LLM/dflash2-large-vulkan.md](docs/LLM/dflash2-large-vulkan.md).
|
||||
[serverAppConfigs-docs/LLM/dflash2-large-vulkan.md](serverAppConfigs-docs/LLM/dflash2-large-vulkan.md).
|
||||
|
||||
### FastMTP patched llama.cpp (Dankserver, retired 2026-08-18)
|
||||
|
||||
@@ -442,17 +442,17 @@ graph TD
|
||||
(EOS or limit) logs only `slot release` with `truncated = 0`. The server
|
||||
never preempts a running generation. When all slots are busy, new tasks
|
||||
defer into a queue. See the 2026-08-13 incident in
|
||||
[docs/LLM/deployment.md](docs/LLM/deployment.md).
|
||||
[serverAppConfigs-docs/LLM/deployment.md](serverAppConfigs-docs/LLM/deployment.md).
|
||||
- ComfyUI on Dankclaw runs CPU-only (`--cpu`). ROCm wheels do not support
|
||||
gfx1151. Do not use CUDA images.
|
||||
- SearXNG outbound traffic must stay on the Gluetun tunnel. Do not move
|
||||
its ports off the gluetun service.
|
||||
- Retired hardware history: the Dankserver 35B cuBLAS crash and the DFlash
|
||||
premature-EOS bug are historical. See
|
||||
[docs/LLM/dankserver-vram-growth.md](docs/LLM/dankserver-vram-growth.md)
|
||||
and [docs/LLM/qwen3.8-spec-matrix.md](docs/LLM/qwen3.8-spec-matrix.md).
|
||||
[serverAppConfigs-docs/LLM/dankserver-vram-growth.md](serverAppConfigs-docs/LLM/dankserver-vram-growth.md)
|
||||
and [serverAppConfigs-docs/LLM/qwen3.8-spec-matrix.md](serverAppConfigs-docs/LLM/qwen3.8-spec-matrix.md).
|
||||
The FastFlowLM NPU endpoint is retired. See
|
||||
[docs/LLM/FastFlowLM NPU Inference.md](docs/LLM/FastFlowLM%20NPU%20Inference.md).
|
||||
[serverAppConfigs-docs/LLM/FastFlowLM NPU Inference.md](serverAppConfigs-docs/LLM/FastFlowLM%20NPU%20Inference.md).
|
||||
|
||||
### Dankclaw memory model
|
||||
|
||||
@@ -478,7 +478,7 @@ two hosts, one Caddy, and one Gitea. One repo keeps them in one history.
|
||||
| Editing a compose/Caddyfile/serve script | **Work through git** — fetch, commit, edit, test, push, pull, deploy. Never edit on the remote directly. |
|
||||
| Config exists only on remote | **Pull it into the repo first** — commit the fetched version (redacted) before making changes. |
|
||||
| Unstaged local changes | **Commit or discard** — check `git status` before starting work. Ask the user if unsure. |
|
||||
| Deploying a committed change | **Run `scripts/deploy.sh <target>`** — it pushes, pulls with fast-forward-only, plans changed paths, dispatches selected services, and checks their health. See [docs/LLM/deployment.md](docs/LLM/deployment.md). | | Container without a Quadlet unit | **Give it one** — self-healing, boot-persistent `.container` unit via git (see Boot Persistence & Self-Healing). |
|
||||
| Deploying a committed change | **Run `scripts/deploy.sh <target>`** — it pushes, pulls with fast-forward-only, plans changed paths, dispatches selected services, and checks their health. See [serverAppConfigs-docs/LLM/deployment.md](serverAppConfigs-docs/LLM/deployment.md). | | Container without a Quadlet unit | **Give it one** — self-healing, boot-persistent `.container` unit via git (see Boot Persistence & Self-Healing). |
|
||||
| Benchmarking | **Stop the service first**, restart, verify health. See the Benchmarking Policy above. |
|
||||
| Deleting a file | **Move it to trash** — `.AGENTTRASH/` (in-repo) or `~/.AGENTTRASH/YYYYMMDD-topic`. Never `rm`. |
|
||||
| Tests exist | **Run them** — verify tests pass after every change. Do not commit failing tests. |
|
||||
|
||||
Reference in new issue
Block a user