aaak-vault-sync 1.0.0

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.
@@ -0,0 +1,13 @@
1
+ # AAAK Memory Loader
2
+
3
+ Use these instructions in any LLM system prompt, agent profile, or custom instructions.
4
+
5
+ If `OBSIDIAN_VAULT_PATH` is set and `$OBSIDIAN_VAULT_PATH/aaak/aaak_index.md` exists:
6
+
7
+ 1. Read `$OBSIDIAN_VAULT_PATH/aaak/aaak_index.md`
8
+ 2. Scan the Topics column for entries relevant to the current task
9
+ 3. Read the linked AAAK files for compressed summaries
10
+ 4. If more detail is needed, follow each `SOURCE:` line back to the original markdown
11
+ 5. If tooling prefers structured data, use `$OBSIDIAN_VAULT_PATH/aaak/aaak_index.json` instead
12
+
13
+ If the vault path or index files do not exist, skip silently.
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: scan-vault
3
+ description: Sync the Obsidian vault to AAAK format. Scans for new/updated markdown files and converts them to compressed AAAK summaries.
4
+ ---
5
+
6
+ Sync the Obsidian vault to AAAK memory format.
7
+
8
+ First, check whether `OBSIDIAN_VAULT_PATH` is set:
9
+
10
+ ```bash
11
+ echo "${OBSIDIAN_VAULT_PATH:-NOT_SET}"
12
+ ```
13
+
14
+ If it is `NOT_SET`, stop and tell the user:
15
+ > `OBSIDIAN_VAULT_PATH` is not set. Add it to your shell profile (`~/.zshrc` or `~/.bashrc`):
16
+ > ```
17
+ > export OBSIDIAN_VAULT_PATH=/path/to/your/vault
18
+ > ```
19
+ > Then restart your shell and re-invoke `/scan-vault`.
20
+
21
+ If it is set, run:
22
+
23
+ ```bash
24
+ aaak-scan --verbose
25
+ ```
26
+
27
+ After running, report:
28
+ - How many files were newly converted
29
+ - How many files were updated (mtime changed)
30
+ - How many files were skipped (already current)
31
+ - Any errors encountered
32
+ - The location of the updated index: `$OBSIDIAN_VAULT_PATH/aaak/aaak_index.md`