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 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.24`.
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 and whether local identity, telemetry, or generated-view paths are still tracked in the git index from older versions. If those paths are still tracked, `doctor` prints a one-time `git rm --cached` command to untrack them.
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/`, and the installer ignores those generated paths by default in `.gitignore`.
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.
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-wiki-toolkit-linux-arm64",
3
- "version": "0.1.24",
3
+ "version": "0.1.26",
4
4
  "description": "Platform binary package for ai-wiki-toolkit (linux-arm64-glibc).",
5
5
  "license": "MIT",
6
6
  "homepage": "https://github.com/BochengYin/ai-wiki-toolkit#readme",