ai-wiki-toolkit-linux-arm64 0.1.24 → 0.1.26
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 +27 -3
- package/bin/aiwiki-toolkit +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# ai-wiki-toolkit-linux-arm64
|
|
2
2
|
|
|
3
3
|
This package contains the `aiwiki-toolkit` executable for `linux-arm64-glibc`.
|
|
4
|
-
It is published as the platform-specific binary package for `ai-wiki-toolkit` `0.1.
|
|
4
|
+
It is published as the platform-specific binary package for `ai-wiki-toolkit` `0.1.26`.
|
|
5
5
|
Most users should install `ai-wiki-toolkit` instead of using this package directly.
|
|
6
6
|
|
|
7
7
|
---
|
|
@@ -91,6 +91,11 @@ That is why the installer manages both wiki files and prompt wiring together:
|
|
|
91
91
|
- `.agents/skills/ai-wiki-reuse-check/` and `.agents/skills/ai-wiki-update-check/` provide repeatable end-of-task checks for Codex-style agent runs
|
|
92
92
|
- `.agents/skills/ai-wiki-clarify-before-code/` and `.agents/skills/ai-wiki-capture-review-learning/` help agents clarify ambiguous requests and preserve reusable review feedback
|
|
93
93
|
|
|
94
|
+
Some runtimes can discover repo-local `.agents/skills/` files on disk but still not expose those
|
|
95
|
+
skills to the active model session. The managed `ai-wiki/_toolkit/system.md` includes fallback
|
|
96
|
+
paths so agents can manually read the relevant `SKILL.md` and `references/` files when runtime skill
|
|
97
|
+
exposure is missing.
|
|
98
|
+
|
|
94
99
|
The toolkit does not replace coding agents. It gives them a shared repo-local memory layer so they can avoid repeating the same review issues, misunderstanding the same requirements, or rediscovering the same fixes.
|
|
95
100
|
|
|
96
101
|
## Task-Aware Context Routing
|
|
@@ -254,6 +259,7 @@ npm install -g ai-wiki-toolkit@latest
|
|
|
254
259
|
after install. That is intentional: they are placeholders for rules and decisions your team has
|
|
255
260
|
actually made, not generic package defaults.
|
|
256
261
|
- `ai-wiki/_toolkit/system.md` is the managed entrypoint for package-managed repo guidance and evolving read order.
|
|
262
|
+
- `ai-wiki/_toolkit/system.md` also includes runtime skill fallback guidance for agents whose active session does not expose repo-local `.agents/skills/`.
|
|
257
263
|
- `ai-wiki/index.md` is a repo-owned map, not a package upgrade surface.
|
|
258
264
|
- `ai-wiki/_toolkit/workflows.md` carries the managed baseline workflows that package upgrades can refresh.
|
|
259
265
|
- Agents should extend user-owned workflow docs instead of editing `_toolkit/**`.
|
|
@@ -409,6 +415,24 @@ If you need a fresh local telemetry and work snapshot, regenerate package-manage
|
|
|
409
415
|
aiwiki-toolkit refresh-metrics
|
|
410
416
|
```
|
|
411
417
|
|
|
418
|
+
To inspect memory quality from local reuse and task-check evidence:
|
|
419
|
+
|
|
420
|
+
```bash
|
|
421
|
+
aiwiki-toolkit diagnose memory
|
|
422
|
+
aiwiki-toolkit diagnose memory --since 14d --handle your-handle
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
This writes regenerated local reports under `ai-wiki/_toolkit/diagnostics/` and prints the report to stdout. The report highlights high-ROI memory, noisy memory, stale or missing docs, conflict notes, missed-memory signals, and coverage gaps such as document reuse events that were never paired with a task-level reuse check. It does not edit user-owned AI wiki docs.
|
|
426
|
+
|
|
427
|
+
To turn diagnostics and handle-local drafts into a human-reviewable consolidation queue:
|
|
428
|
+
|
|
429
|
+
```bash
|
|
430
|
+
aiwiki-toolkit consolidate queue
|
|
431
|
+
aiwiki-toolkit consolidate queue --since 14d --handle your-handle
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
This writes regenerated local reports under `ai-wiki/_toolkit/consolidation/` and prints the queue to stdout. The queue suggests one action per draft cluster: keep, refine, promotion candidate, conflict, or supersession. It does not edit user-owned AI wiki docs or create shared conventions, review patterns, problems, features, or decisions; those still require human confirmation.
|
|
435
|
+
|
|
412
436
|
To diagnose missing starter pointers, stale managed prompt blocks, or rule drift and print copy-paste upgrade starters:
|
|
413
437
|
|
|
414
438
|
```bash
|
|
@@ -427,7 +451,7 @@ This command does not rewrite user-owned repo docs. It prints which paths need a
|
|
|
427
451
|
- `ai-wiki/people/<handle>/index.md`
|
|
428
452
|
- `ai-wiki/metrics/index.md`
|
|
429
453
|
|
|
430
|
-
It also checks whether the managed `.gitignore` block is present
|
|
454
|
+
It also checks whether the managed `.gitignore` block is present, whether local identity, telemetry, or generated-view paths are still tracked in the git index from older versions, and whether managed system rules include the runtime skill fallback used when repo-local AI wiki skills are present but not exposed by the active agent runtime. If local-state paths are still tracked, `doctor` prints a one-time `git rm --cached` command to untrack them.
|
|
431
455
|
|
|
432
456
|
To remove the managed layer while keeping your user-owned wiki documents:
|
|
433
457
|
|
|
@@ -462,7 +486,7 @@ Even with `--purge-user-docs --yes`, the shared home wiki under `~/ai-wiki/syste
|
|
|
462
486
|
- `ai-wiki/index.md` is a repo-owned map and is not treated as a starter-drift upgrade target by `doctor`.
|
|
463
487
|
- `ai-wiki/workflows.md` remains user-owned; package-managed workflow updates land in `ai-wiki/_toolkit/workflows.md` instead of rewriting the repo-owned file.
|
|
464
488
|
- `.env.aiwiki` stores the current local actor identity in a managed block. It is gitignored and should not be committed.
|
|
465
|
-
- `ai-wiki/metrics/reuse-events/<handle>.jsonl` and `ai-wiki/metrics/task-checks/<handle>.jsonl` are user-owned evidence data. `ai-wiki/work/events/<handle>.jsonl` is user-owned work state. Package-managed aggregate views are regenerated under `ai-wiki/_toolkit/metrics/` and `ai-wiki/_toolkit/work
|
|
489
|
+
- `ai-wiki/metrics/reuse-events/<handle>.jsonl` and `ai-wiki/metrics/task-checks/<handle>.jsonl` are user-owned evidence data. `ai-wiki/work/events/<handle>.jsonl` is user-owned work state. Package-managed aggregate views are regenerated under `ai-wiki/_toolkit/metrics/` and `ai-wiki/_toolkit/work/`; memory diagnostics are generated under `ai-wiki/_toolkit/diagnostics/`; consolidation queues are generated under `ai-wiki/_toolkit/consolidation/`. The installer ignores those generated paths by default in `.gitignore`.
|
|
466
490
|
- Legacy flat files such as `ai-wiki/metrics/reuse-events.jsonl` and `ai-wiki/metrics/task-checks.jsonl` are still read for compatibility, but new writes should use the handle-sharded layout.
|
|
467
491
|
- `aiwiki-toolkit doctor --suggest-index-upgrade` prints suggested replacements for missing repo starter docs and repo-owned companion docs such as `ai-wiki/workflows.md`, but it does not overwrite them automatically.
|
|
468
492
|
- Package-owned `.agents/skills/ai-wiki-reuse-check/**`, `.agents/skills/ai-wiki-update-check/**`, `.agents/skills/ai-wiki-clarify-before-code/**`, `.agents/skills/ai-wiki-capture-review-learning/**`, and `.agents/skills/ai-wiki-consolidate-drafts/**` are refreshed by `install` so package workflow updates reach existing repos.
|
package/bin/aiwiki-toolkit
CHANGED
|
Binary file
|
package/package.json
CHANGED