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 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.23`.
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 reads `ai-wiki/_toolkit/system.md`
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 or global git config
312
- 3. `unknown`
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/`, and the installer ignores those generated paths by default in `.gitignore`.
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.
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-wiki-toolkit-linux-arm64",
3
- "version": "0.1.23",
3
+ "version": "0.1.25",
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",