incitaciones 0.10.2 → 0.10.3

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.
@@ -49,17 +49,37 @@ Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and
49
49
  grep -i "<slug>" "$JOURNAL"/inbox.md
50
50
  ```
51
51
 
52
- 7. **Check `~/.whisper/` for accumulated knowledge.**
53
- If `~/.whisper/` exists, load context:
52
+ 7. **Check for accumulated whisper knowledge.**
53
+
54
+ **If `turu` is available** (`turu key --json` succeeds), delegate every
55
+ mechanical step to it — never hand-roll repo-key or path derivation:
56
+ ```bash
57
+ turu key --json # canonical repo key, branch slug, worktree slot
58
+ turu recall repo # repo-scope knowledge (env facts)
59
+ turu recall branch # branch-scope knowledge (notes)
60
+ turu recall worktree # worktree-slot knowledge (only when step 8 uses one)
61
+ ```
62
+ - `turu recall` output already routes to the right store (global, repo,
63
+ or repo-local `.whisper/`), so never `ls`/`find` `~/.whisper/` to guess
64
+ paths — canonical keys don't match raw remote URLs.
65
+ - `turu recall` exits non-zero with `nothing to recall in this scope`
66
+ when a scope is empty — treat that as "no knowledge here", not a
67
+ failure; move on without improvising alternate lookup paths.
68
+
69
+ **Fallback (turu absent):** if `~/.whisper/` exists, load context with:
54
70
  ```bash
55
71
  repo_url=$(git remote get-url origin 2>/dev/null | sed 's|https://||;s|git@||;s|\.git$||')
56
72
  branch_slug=$(git rev-parse --abbrev-ref HEAD | sed 's|/|--|g')
57
73
  whisper_dir=~/.whisper/repos/"${repo_url}"/branches/"${branch_slug}"
58
74
  ```
59
- - Read `context.md` if it exists (extract beads-epic, status)
60
- - Read `plan.md` if it has real content
61
75
  - Read `notes.md` if it has real content
62
76
  - Read `env.md` at repo level for infra facts
77
+ - If the repo has a committed repo-local `.whisper/` directory, prefer
78
+ that over the global path. Its layout mirrors the global one relative
79
+ to the repo root:
80
+ `.whisper/repos/<org-path>/<repo>/branches/<branch-slug>/notes.md`
81
+ (e.g. `.whisper/repos/ak/PhormaSci/talleres/branches/main/notes.md`).
82
+
63
83
  - If beads is available, fetch open issues:
64
84
  ```bash
65
85
  bd list --label branch:<branch> 2>/dev/null
@@ -93,9 +113,9 @@ Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and
93
113
  **Related inbox items** *(if any)*
94
114
  - items that mention this project
95
115
 
96
- **Whisper context** *(if ~/.whisper/ exists)*
97
- - Plan: summary of current plan
98
- - Notes: key findings
116
+ **Whisper context** *(if turu recall or the fallback found content)*
117
+ - Env: repo-scope infra facts (`turu recall repo` / `env.md`)
118
+ - Notes: branch-scope findings (`turu recall branch` / `notes.md`)
99
119
  - Beads issues: <n> open, <n> in_progress
100
120
 
101
121
  **⚠ Active in flight** *(omit if none)*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "incitaciones",
3
- "version": "0.10.2",
3
+ "version": "0.10.3",
4
4
  "description": "Reusable prompts and skills for CLI LLM tools, with native pi package support.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -63,17 +63,37 @@ Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and
63
63
  grep -i "<slug>" "$JOURNAL"/inbox.md
64
64
  ```
65
65
 
66
- 7. **Check `~/.whisper/` for accumulated knowledge.**
67
- If `~/.whisper/` exists, load context:
66
+ 7. **Check for accumulated whisper knowledge.**
67
+
68
+ **If `turu` is available** (`turu key --json` succeeds), delegate every
69
+ mechanical step to it — never hand-roll repo-key or path derivation:
70
+ ```bash
71
+ turu key --json # canonical repo key, branch slug, worktree slot
72
+ turu recall repo # repo-scope knowledge (env facts)
73
+ turu recall branch # branch-scope knowledge (notes)
74
+ turu recall worktree # worktree-slot knowledge (only when step 8 uses one)
75
+ ```
76
+ - `turu recall` output already routes to the right store (global, repo,
77
+ or repo-local `.whisper/`), so never `ls`/`find` `~/.whisper/` to guess
78
+ paths — canonical keys don't match raw remote URLs.
79
+ - `turu recall` exits non-zero with `nothing to recall in this scope`
80
+ when a scope is empty — treat that as "no knowledge here", not a
81
+ failure; move on without improvising alternate lookup paths.
82
+
83
+ **Fallback (turu absent):** if `~/.whisper/` exists, load context with:
68
84
  ```bash
69
85
  repo_url=$(git remote get-url origin 2>/dev/null | sed 's|https://||;s|git@||;s|\.git$||')
70
86
  branch_slug=$(git rev-parse --abbrev-ref HEAD | sed 's|/|--|g')
71
87
  whisper_dir=~/.whisper/repos/"${repo_url}"/branches/"${branch_slug}"
72
88
  ```
73
- - Read `context.md` if it exists (extract beads-epic, status)
74
- - Read `plan.md` if it has real content
75
89
  - Read `notes.md` if it has real content
76
90
  - Read `env.md` at repo level for infra facts
91
+ - If the repo has a committed repo-local `.whisper/` directory, prefer
92
+ that over the global path. Its layout mirrors the global one relative
93
+ to the repo root:
94
+ `.whisper/repos/<org-path>/<repo>/branches/<branch-slug>/notes.md`
95
+ (e.g. `.whisper/repos/ak/PhormaSci/talleres/branches/main/notes.md`).
96
+
77
97
  - If beads is available, fetch open issues:
78
98
  ```bash
79
99
  bd list --label branch:<branch> 2>/dev/null
@@ -107,9 +127,9 @@ Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and
107
127
  **Related inbox items** *(if any)*
108
128
  - items that mention this project
109
129
 
110
- **Whisper context** *(if ~/.whisper/ exists)*
111
- - Plan: summary of current plan
112
- - Notes: key findings
130
+ **Whisper context** *(if turu recall or the fallback found content)*
131
+ - Env: repo-scope infra facts (`turu recall repo` / `env.md`)
132
+ - Notes: branch-scope findings (`turu recall branch` / `notes.md`)
113
133
  - Beads issues: <n> open, <n> in_progress
114
134
 
115
135
  **⚠ Active in flight** *(omit if none)*
@@ -49,17 +49,37 @@ Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and
49
49
  grep -i "<slug>" "$JOURNAL"/inbox.md
50
50
  ```
51
51
 
52
- 7. **Check `~/.whisper/` for accumulated knowledge.**
53
- If `~/.whisper/` exists, load context:
52
+ 7. **Check for accumulated whisper knowledge.**
53
+
54
+ **If `turu` is available** (`turu key --json` succeeds), delegate every
55
+ mechanical step to it — never hand-roll repo-key or path derivation:
56
+ ```bash
57
+ turu key --json # canonical repo key, branch slug, worktree slot
58
+ turu recall repo # repo-scope knowledge (env facts)
59
+ turu recall branch # branch-scope knowledge (notes)
60
+ turu recall worktree # worktree-slot knowledge (only when step 8 uses one)
61
+ ```
62
+ - `turu recall` output already routes to the right store (global, repo,
63
+ or repo-local `.whisper/`), so never `ls`/`find` `~/.whisper/` to guess
64
+ paths — canonical keys don't match raw remote URLs.
65
+ - `turu recall` exits non-zero with `nothing to recall in this scope`
66
+ when a scope is empty — treat that as "no knowledge here", not a
67
+ failure; move on without improvising alternate lookup paths.
68
+
69
+ **Fallback (turu absent):** if `~/.whisper/` exists, load context with:
54
70
  ```bash
55
71
  repo_url=$(git remote get-url origin 2>/dev/null | sed 's|https://||;s|git@||;s|\.git$||')
56
72
  branch_slug=$(git rev-parse --abbrev-ref HEAD | sed 's|/|--|g')
57
73
  whisper_dir=~/.whisper/repos/"${repo_url}"/branches/"${branch_slug}"
58
74
  ```
59
- - Read `context.md` if it exists (extract beads-epic, status)
60
- - Read `plan.md` if it has real content
61
75
  - Read `notes.md` if it has real content
62
76
  - Read `env.md` at repo level for infra facts
77
+ - If the repo has a committed repo-local `.whisper/` directory, prefer
78
+ that over the global path. Its layout mirrors the global one relative
79
+ to the repo root:
80
+ `.whisper/repos/<org-path>/<repo>/branches/<branch-slug>/notes.md`
81
+ (e.g. `.whisper/repos/ak/PhormaSci/talleres/branches/main/notes.md`).
82
+
63
83
  - If beads is available, fetch open issues:
64
84
  ```bash
65
85
  bd list --label branch:<branch> 2>/dev/null
@@ -93,9 +113,9 @@ Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and
93
113
  **Related inbox items** *(if any)*
94
114
  - items that mention this project
95
115
 
96
- **Whisper context** *(if ~/.whisper/ exists)*
97
- - Plan: summary of current plan
98
- - Notes: key findings
116
+ **Whisper context** *(if turu recall or the fallback found content)*
117
+ - Env: repo-scope infra facts (`turu recall repo` / `env.md`)
118
+ - Notes: branch-scope findings (`turu recall branch` / `notes.md`)
99
119
  - Beads issues: <n> open, <n> in_progress
100
120
 
101
121
  **⚠ Active in flight** *(omit if none)*