agentpack-cli 0.1.6 → 0.1.8
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 +52 -64
- package/dist/src/cli/index.js +37 -6
- package/dist/src/cli/index.js.map +1 -1
- package/dist/src/integrations/install.js +6 -0
- package/dist/src/integrations/install.js.map +1 -1
- package/dist/src/operations.d.ts +2 -0
- package/dist/src/operations.js +56 -1
- package/dist/src/operations.js.map +1 -1
- package/docs/CLI.md +62 -0
- package/docs/MCP.md +13 -2
- package/docs/ROADMAP.md +4 -2
- package/docs/VISION.md +43 -0
- package/docs/agentpack-architecture.html +1330 -0
- package/docs/agentpack-architecture.json +838 -0
- package/package.json +1 -1
- package/docs/agentpack-flow.md +0 -63
package/package.json
CHANGED
package/docs/agentpack-flow.md
DELETED
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
# Agentpack Execution Flow
|
|
2
|
-
|
|
3
|
-
```mermaid
|
|
4
|
-
flowchart TD
|
|
5
|
-
cli["agentpack <cmd><br/>Terminal / CI"]
|
|
6
|
-
mcp["agentpack mcp<br/>Codex / Claude Code / Cursor / Desktop"]
|
|
7
|
-
|
|
8
|
-
cli --> dispatch["Command dispatch<br/>src/cli/index.ts"]
|
|
9
|
-
mcp --> root["MCP root resolution<br/>--root > AGENTPACK_ROOT > cwd"]
|
|
10
|
-
root --> server["MCP tool server<br/>src/mcp/server.ts"]
|
|
11
|
-
server --> dispatch
|
|
12
|
-
|
|
13
|
-
dispatch --> init["init<br/>create .agentpack/<br/>append local-only .gitignore patterns"]
|
|
14
|
-
dispatch --> install["install client<br/>project-local config<br/>or Desktop merge snippet"]
|
|
15
|
-
dispatch --> sourceAdd["source add<br/>hash file + store source conclusion"]
|
|
16
|
-
dispatch --> sourceStatus["source status<br/>UNCHANGED / CHANGED / MISSING"]
|
|
17
|
-
dispatch --> records["record_decision<br/>record_dead_end<br/>attach_evidence"]
|
|
18
|
-
dispatch --> checkpoint["checkpoint<br/>state + event + snapshot"]
|
|
19
|
-
dispatch --> resume["resume / load_context<br/>budgeted task context"]
|
|
20
|
-
dispatch --> replay["replay / diff<br/>timeline or checkpoint delta"]
|
|
21
|
-
dispatch --> doctor["doctor<br/>pack health + MCP setup checks"]
|
|
22
|
-
|
|
23
|
-
init --> storage
|
|
24
|
-
install --> localConfig["Project-local client config<br/>.codex/config.toml<br/>.mcp.json<br/>.cursor/mcp.json"]
|
|
25
|
-
sourceAdd --> operations["src/operations.ts<br/>hash + git status helpers"]
|
|
26
|
-
sourceStatus --> operations
|
|
27
|
-
records --> storage
|
|
28
|
-
checkpoint --> checkpoints["src/core/checkpoints.ts<br/>serialized writes under .lock"]
|
|
29
|
-
resume --> resumeBuilder["src/core/resume.ts<br/>pack root header + query filter"]
|
|
30
|
-
resumeBuilder --> budget["src/core/budget.ts<br/>truncate / omit sections"]
|
|
31
|
-
doctor --> doctorCore["src/core/doctor.ts<br/>local ignores + stale roots + source cache"]
|
|
32
|
-
|
|
33
|
-
operations --> storage
|
|
34
|
-
checkpoints --> storage
|
|
35
|
-
budget --> output
|
|
36
|
-
replay --> output
|
|
37
|
-
sourceStatus --> output
|
|
38
|
-
doctorCore --> output
|
|
39
|
-
|
|
40
|
-
storage[(".agentpack/<br/>state.json<br/>sources.json<br/>events.jsonl<br/>checkpoints/<br/>evidence/<br/>instructions/")]
|
|
41
|
-
output["Output to coding agent<br/>Pack root<br/>Git state<br/>Source cache guidance<br/>Decisions / dead ends / evidence<br/>Next actions"]
|
|
42
|
-
|
|
43
|
-
classDef entry fill:#0c2044,stroke:#388bfd,color:#c9d1d9;
|
|
44
|
-
classDef rootNode fill:#2a1d00,stroke:#d29922,color:#c9d1d9;
|
|
45
|
-
classDef command fill:#161b22,stroke:#30363d,color:#c9d1d9;
|
|
46
|
-
classDef core fill:#0a2a14,stroke:#3fb950,color:#c9d1d9;
|
|
47
|
-
classDef store fill:#1a0c3a,stroke:#8957e5,color:#c9d1d9;
|
|
48
|
-
classDef out fill:#0a2020,stroke:#39d353,color:#c9d1d9;
|
|
49
|
-
|
|
50
|
-
class cli,mcp entry;
|
|
51
|
-
class root rootNode;
|
|
52
|
-
class dispatch,init,install,sourceAdd,sourceStatus,records,checkpoint,resume,replay,doctor command;
|
|
53
|
-
class server,operations,checkpoints,resumeBuilder,budget,doctorCore,localConfig core;
|
|
54
|
-
class storage store;
|
|
55
|
-
class output out;
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
## Notes
|
|
59
|
-
|
|
60
|
-
- Normal CLI commands find the nearest `.agentpack/` root upward from the current working directory after `agentpack init`.
|
|
61
|
-
- MCP clients can also pass an explicit root. Agentpack resolves MCP roots as `--root`, then `AGENTPACK_ROOT`, then `cwd`.
|
|
62
|
-
- Codex, Claude Code, and Cursor use project-local config. Claude Desktop needs a merge snippet because its config is global.
|
|
63
|
-
- `.agentpack/` is local-only by default and should not be committed in v0.
|