ai-wiki-toolkit-linux-arm64 0.1.23 → 0.1.25
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 +37 -5
- 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.25`.
|
|
5
5
|
Most users should install `ai-wiki-toolkit` instead of using this package directly.
|
|
6
6
|
|
|
7
7
|
---
|
|
@@ -301,15 +301,29 @@ aiwiki-toolkit init
|
|
|
301
301
|
- generate package-managed `_toolkit/index.md`, `_toolkit/workflows.md`, `_toolkit/catalog.json`, `_toolkit/schema/reuse-v1.md`, `_toolkit/schema/team-memory-v1.md`, `_toolkit/schema/work-v1.md`, `_toolkit/metrics/*.json`, and `_toolkit/work/*`
|
|
302
302
|
- upsert a managed `.gitignore` block that ignores `.env.aiwiki`, AI wiki telemetry, and generated aggregate snapshots so routine agent use does not dirty `git status`
|
|
303
303
|
- create or refresh 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/`
|
|
304
|
-
- update `AGENT.md`, `AGENTS.md`, and/or `CLAUDE.md` with a managed instruction block that
|
|
304
|
+
- update `AGENT.md`, `AGENTS.md`, and/or `CLAUDE.md` with a short managed instruction block that points agents to `ai-wiki/_toolkit/system.md` when the repo contains `ai-wiki/`
|
|
305
305
|
|
|
306
306
|
If no supported prompt file exists, it creates `AGENT.md`.
|
|
307
307
|
|
|
308
308
|
If `--handle` is not passed, the tool resolves a handle from:
|
|
309
309
|
|
|
310
310
|
1. `AIWIKI_TOOLKIT_HANDLE`
|
|
311
|
-
2. local
|
|
312
|
-
3.
|
|
311
|
+
2. the repo-local `.env.aiwiki`
|
|
312
|
+
3. local or global git config
|
|
313
|
+
4. an interactive team ID prompt
|
|
314
|
+
|
|
315
|
+
The prompt appears only when no usable handle can be resolved:
|
|
316
|
+
|
|
317
|
+
```text
|
|
318
|
+
Could not detect a git user.name or user.email.
|
|
319
|
+
|
|
320
|
+
AI wiki needs a stable local ID for your team identity.
|
|
321
|
+
What ID would you prefer to use in this team?
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
The entered ID is normalized into a path- and branch-safe handle, stored in
|
|
325
|
+
`.env.aiwiki`, and used for paths such as `ai-wiki/people/<handle>/`. In
|
|
326
|
+
non-interactive shells, pass `--handle your-name` or set `AIWIKI_TOOLKIT_HANDLE`.
|
|
313
327
|
|
|
314
328
|
The tool works best when `git user.name` and `git user.email` are configured first.
|
|
315
329
|
|
|
@@ -395,6 +409,24 @@ If you need a fresh local telemetry and work snapshot, regenerate package-manage
|
|
|
395
409
|
aiwiki-toolkit refresh-metrics
|
|
396
410
|
```
|
|
397
411
|
|
|
412
|
+
To inspect memory quality from local reuse and task-check evidence:
|
|
413
|
+
|
|
414
|
+
```bash
|
|
415
|
+
aiwiki-toolkit diagnose memory
|
|
416
|
+
aiwiki-toolkit diagnose memory --since 14d --handle your-handle
|
|
417
|
+
```
|
|
418
|
+
|
|
419
|
+
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.
|
|
420
|
+
|
|
421
|
+
To turn diagnostics and handle-local drafts into a human-reviewable consolidation queue:
|
|
422
|
+
|
|
423
|
+
```bash
|
|
424
|
+
aiwiki-toolkit consolidate queue
|
|
425
|
+
aiwiki-toolkit consolidate queue --since 14d --handle your-handle
|
|
426
|
+
```
|
|
427
|
+
|
|
428
|
+
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.
|
|
429
|
+
|
|
398
430
|
To diagnose missing starter pointers, stale managed prompt blocks, or rule drift and print copy-paste upgrade starters:
|
|
399
431
|
|
|
400
432
|
```bash
|
|
@@ -448,7 +480,7 @@ Even with `--purge-user-docs --yes`, the shared home wiki under `~/ai-wiki/syste
|
|
|
448
480
|
- `ai-wiki/index.md` is a repo-owned map and is not treated as a starter-drift upgrade target by `doctor`.
|
|
449
481
|
- `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.
|
|
450
482
|
- `.env.aiwiki` stores the current local actor identity in a managed block. It is gitignored and should not be committed.
|
|
451
|
-
- `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
|
|
483
|
+
- `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`.
|
|
452
484
|
- 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.
|
|
453
485
|
- `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.
|
|
454
486
|
- 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