@jetrabbits/agentic 0.0.5 → 0.2.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.
- package/AGENTS.md +7 -0
- package/CHANGELOG.md +12 -0
- package/Makefile +31 -3
- package/README.md +23 -2
- package/agentic +1019 -90
- package/docs/agentic-lifecycle.md +11 -0
- package/docs/agentic-token-minimization/README.md +2 -0
- package/docs/agentic-usage.md +59 -2
- package/docs/opencode_setup.md +3 -0
- package/package.json +2 -1
package/AGENTS.md
CHANGED
|
@@ -76,6 +76,13 @@ Cross-cutting practices that apply to every project regardless of area.
|
|
|
76
76
|
- Resolve the library or framework identity first, then request focused docs for the exact task and version when version matters.
|
|
77
77
|
- If Context7 is unavailable, state that explicitly and fall back to local docs or official project documentation.
|
|
78
78
|
|
|
79
|
+
### MemPalace + Context Strategy
|
|
80
|
+
|
|
81
|
+
- If MemPalace MCP is enabled and available, load project business/domain context from MemPalace first.
|
|
82
|
+
- If Context7 MCP is enabled and available, use it specifically for framework/library/API documentation.
|
|
83
|
+
- If both are available, combine them: MemPalace for project/business knowledge, Context7 for framework-level references.
|
|
84
|
+
- If MCP providers are unavailable, continue with standard local-repo discovery and context-building as fallback.
|
|
85
|
+
|
|
79
86
|
### Code Style
|
|
80
87
|
|
|
81
88
|
- Write self-documenting code with meaningful names — comments explain why, not what.
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## v0.2.0
|
|
4
|
+
|
|
5
|
+
- Added `agentic --version` and version display in CLI/TUI output.
|
|
6
|
+
- Added post-install doctor smoke checks for selected real agent targets.
|
|
7
|
+
- Added timestamped install logging with a mirrored `/tmp/agentic-*` file.
|
|
8
|
+
- Added install/TUI runtime requirements checks for Python, pip, and managed-file hashing tools.
|
|
9
|
+
- Changed generated MemPalace MCP configs to call `mempalace-mcp` without arguments.
|
|
10
|
+
- Added opt-in real-agent doctor E2E coverage.
|
|
11
|
+
- Added version metadata for generated Agentic markers while preserving the GitHub repository link.
|
|
12
|
+
- Kept schema-sensitive agent configuration files free of Agentic marker metadata.
|
package/Makefile
CHANGED
|
@@ -1,11 +1,17 @@
|
|
|
1
|
-
.PHONY: help install dev test lint fmt clean build assess-areas
|
|
1
|
+
.PHONY: help install dev test test-cli test-tui test-cross test-doctor test-markers test-real-agent-doctor lint fmt clean build assess-areas
|
|
2
2
|
|
|
3
3
|
help:
|
|
4
4
|
@printf '%s\n' \
|
|
5
5
|
"Available targets:" \
|
|
6
6
|
" install Install local development prerequisites" \
|
|
7
7
|
" dev Show local development entrypoints" \
|
|
8
|
-
" test Run end-to-end tests" \
|
|
8
|
+
" test Run end-to-end tests (all groups)" \
|
|
9
|
+
" test-cli Run CLI end-to-end tests" \
|
|
10
|
+
" test-tui Run TUI end-to-end tests" \
|
|
11
|
+
" test-cross Run cross-mode end-to-end tests" \
|
|
12
|
+
" test-doctor Run deterministic doctor end-to-end tests" \
|
|
13
|
+
" test-markers Run generated marker and idempotency tests" \
|
|
14
|
+
" test-real-agent-doctor Run opt-in real agent doctor checks" \
|
|
9
15
|
" lint Run prompt and catalog validation" \
|
|
10
16
|
" fmt Check formatting hooks placeholder" \
|
|
11
17
|
" clean Remove generated reports" \
|
|
@@ -19,7 +25,29 @@ dev:
|
|
|
19
25
|
@printf '%s\n' "Use ./agentic tui or ./agentic install ..."
|
|
20
26
|
|
|
21
27
|
test:
|
|
22
|
-
bash tests/e2e/
|
|
28
|
+
bash tests/e2e/cli.e2e.sh
|
|
29
|
+
bash tests/e2e/tui.e2e.sh
|
|
30
|
+
bash tests/e2e/cross.e2e.sh
|
|
31
|
+
bash tests/e2e/doctor.e2e.sh
|
|
32
|
+
bash tests/e2e/markers.e2e.sh
|
|
33
|
+
|
|
34
|
+
test-cli:
|
|
35
|
+
bash tests/e2e/cli.e2e.sh
|
|
36
|
+
|
|
37
|
+
test-tui:
|
|
38
|
+
bash tests/e2e/tui.e2e.sh
|
|
39
|
+
|
|
40
|
+
test-cross:
|
|
41
|
+
bash tests/e2e/cross.e2e.sh
|
|
42
|
+
|
|
43
|
+
test-doctor:
|
|
44
|
+
bash tests/e2e/doctor.e2e.sh
|
|
45
|
+
|
|
46
|
+
test-markers:
|
|
47
|
+
bash tests/e2e/markers.e2e.sh
|
|
48
|
+
|
|
49
|
+
test-real-agent-doctor:
|
|
50
|
+
bash tests/e2e/real_agent_doctor.e2e.sh
|
|
23
51
|
|
|
24
52
|
lint:
|
|
25
53
|
bash -n agentic
|
package/README.md
CHANGED
|
@@ -95,6 +95,11 @@ agent-guides/
|
|
|
95
95
|
|
|
96
96
|
## Quick start
|
|
97
97
|
|
|
98
|
+
### Requirements
|
|
99
|
+
|
|
100
|
+
- required commands: `bash`, `python3`, `pip`, `pip3`, or `python3 -m pip`, `git`
|
|
101
|
+
- optional commands: `fzf`, `node`/`npm`, `curl`, agent binaries such as `codex`, `opencode`, `claude`, `gemini`
|
|
102
|
+
|
|
98
103
|
### Install
|
|
99
104
|
|
|
100
105
|
```bash
|
|
@@ -162,8 +167,8 @@ Each agent has a `vibe` (one-line personality), `Identity`, `Communication Style
|
|
|
162
167
|
|
|
163
168
|
## What gets installed where
|
|
164
169
|
|
|
165
|
-
|
|
166
|
-
|
|
170
|
+
`agentic` installs shared guidance into `.agent/` and selected IDE files into directories like `.claude/`,
|
|
171
|
+
`.opencode/`, and `.codex/`. Generated runtime guidance goes to `AGENTS.md`; OpenCode also gets `.opencode/AGENTS.md`.
|
|
167
172
|
|
|
168
173
|
```text
|
|
169
174
|
project/.agent/
|
|
@@ -175,6 +180,22 @@ project/.agent/
|
|
|
175
180
|
|
|
176
181
|
---
|
|
177
182
|
|
|
183
|
+
## Agent IDE options (interactive install)
|
|
184
|
+
|
|
185
|
+
### MCP
|
|
186
|
+
|
|
187
|
+
- `context7`: adds a remote MCP server for up-to-date framework, library, SDK, and API documentation.
|
|
188
|
+
- `mempalace`: adds a local memory MCP server for project context discovery and reuse.
|
|
189
|
+
|
|
190
|
+
### OpenCode Plugins
|
|
191
|
+
|
|
192
|
+
- `telegram-opencode-notifier`: sends Telegram notifications when an OpenCode session becomes idle, including the final
|
|
193
|
+
response or an attachment for long output.
|
|
194
|
+
- `llm-quota-checker`: probes configured OpenCode models, reports available/failed models, and updates subagent model
|
|
195
|
+
settings to a working model.
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
178
199
|
## Contributing
|
|
179
200
|
|
|
180
201
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for authoring standards, templates, and the pull request process.
|