@vishal2612200/agentpack 0.3.4 → 0.3.6
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 +18 -4
- package/bin/agentpack.js +1 -1
- package/package.json +1 -3
package/README.md
CHANGED
|
@@ -25,7 +25,7 @@ AgentPack is a context preparation tool, not a coding agent. It stays local, det
|
|
|
25
25
|
- **Budget-aware compression**: emits `full`, `diff`, `symbols`, `skeleton`, or `summary` views instead of all-or-nothing file dumps.
|
|
26
26
|
- **Local code intelligence**: extracts roles, domains, entrypoints, definitions, dependencies, env reads, side effects, and external systems using static analysis.
|
|
27
27
|
- **Agent integrations**: installs Claude Code, Cursor, Windsurf, Codex, Antigravity, VS Code tasks, git hooks, and MCP configuration.
|
|
28
|
-
- **Freshness and deltas**: records task source, git state, snapshot hashes, selected-file deltas,
|
|
28
|
+
- **Freshness and deltas**: records task source, git state, snapshot hashes, selected-file deltas, stale-context warnings, MCP task/repo auto-refresh signals, and a machine-readable `agentpack:freshness` block in markdown fallback artifacts.
|
|
29
29
|
- **Measurable quality**: benchmark expected-file recall, token efficiency, misses, and public smoke suites.
|
|
30
30
|
|
|
31
31
|
## What this npm package is
|
|
@@ -73,7 +73,9 @@ agentpack init --agent codex
|
|
|
73
73
|
agentpack init --agent antigravity
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
-
`agentpack init` creates local `.agentpack/` state
|
|
76
|
+
`agentpack init` creates local `.agentpack/` state, installs the selected integration when supported, seeds `.agentignore` with safe defaults, and imports obvious generated/noisy rules from git ignore sources. `agentpack pack` reads `.agentpack/task.md`, ranks relevant files, and writes the adapter-specific context output.
|
|
77
|
+
|
|
78
|
+
Keep task text concrete. Name feature, route, service, or file path. Broad repo-meta tasks such as `improve context pack quality` or `fix stats noise` can pull README or tool internals by keyword.
|
|
77
79
|
|
|
78
80
|
For a guided setup:
|
|
79
81
|
|
|
@@ -109,7 +111,7 @@ AgentPack is best treated as a ranked starting map. It should reduce repeated or
|
|
|
109
111
|
| Pack time | Seconds on a warm cache; first summarize pass is slower |
|
|
110
112
|
| Recall | Expected files appear near the top; validate with `agentpack benchmark --misses` |
|
|
111
113
|
| Precision | Good enough to reduce exploration; summaries and repo maps may still include noise |
|
|
112
|
-
| Freshness |
|
|
114
|
+
| Freshness | Task or repo-stale MCP reads auto-refresh; static packs are clearly marked by task, git, and snapshot checks |
|
|
113
115
|
|
|
114
116
|
Use real repo evals instead of trusting compression numbers:
|
|
115
117
|
|
|
@@ -123,21 +125,33 @@ agentpack benchmark --public-repos --prove-targets --misses --public-table
|
|
|
123
125
|
## Daily workflow
|
|
124
126
|
|
|
125
127
|
```bash
|
|
126
|
-
printf '%s\n' "
|
|
128
|
+
printf '%s\n' "fix billing webhook retry handling in app/api/billing/route.ts" > .agentpack/task.md
|
|
127
129
|
agentpack pack
|
|
128
130
|
agentpack stats
|
|
129
131
|
```
|
|
130
132
|
|
|
133
|
+
If results look noisy, tighten task text first, then add repo-specific generated paths to `.agentignore` or run `agentpack ignore sync`.
|
|
134
|
+
|
|
135
|
+
`agentpack ignore sync` refreshes imported generated/noisy rules from the root `.gitignore`, nested `.gitignore` files, `.git/info/exclude`, and your global git ignore while leaving your manual `.agentignore` entries alone.
|
|
136
|
+
|
|
131
137
|
## Useful commands
|
|
132
138
|
|
|
133
139
|
```bash
|
|
134
140
|
agentpack status
|
|
141
|
+
agentpack guard --agent auto --repair-stale --refresh-context
|
|
142
|
+
agentpack migrate --path ~/src --discover --agent all
|
|
135
143
|
agentpack doctor --agent all
|
|
136
144
|
agentpack explain --file path/to/file.py
|
|
137
145
|
agentpack benchmark --sample-fixtures --misses
|
|
138
146
|
agentpack repair --agent all
|
|
139
147
|
```
|
|
140
148
|
|
|
149
|
+
`agentpack guard` is the executable pre-edit gate for non-MCP agents. It checks stale context, stale task metadata, repo snapshot drift, and stale installed rule files; with `--repair-stale --refresh-context`, it repairs and refreshes before returning success. `agentpack pack` also self-heals stale AgentPack rule blocks for older installs that still call `pack`.
|
|
150
|
+
|
|
151
|
+
`agentpack migrate --discover` scans existing repo folders and applies the same integration repair across many repos after an upgrade.
|
|
152
|
+
|
|
153
|
+
Native host enforcement skeletons and blocked-status stubs live in `native-integrations/` in the source repo. They are marked `guarded`, not `enforced`, until host APIs expose mandatory pre-edit/pre-tool hooks.
|
|
154
|
+
|
|
141
155
|
## Optional watch and MCP workflows
|
|
142
156
|
|
|
143
157
|
The `watch` and `mcp` commands use optional Python dependencies. If you need those workflows today, add the Python extras to a `pipx` install or use a virtual environment. Avoid global `pip3 install` on system-managed Python: many macOS/Linux distributions block it with PEP 668's `externally-managed-environment`.
|
package/bin/agentpack.js
CHANGED
|
@@ -6,7 +6,7 @@ const fs = require("node:fs");
|
|
|
6
6
|
const os = require("node:os");
|
|
7
7
|
const path = require("node:path");
|
|
8
8
|
|
|
9
|
-
const PACKAGE_VERSION = "0.3.
|
|
9
|
+
const PACKAGE_VERSION = "0.3.6";
|
|
10
10
|
const PYPI_PACKAGE = `agentpack-cli==${PACKAGE_VERSION}`;
|
|
11
11
|
|
|
12
12
|
function compareVersions(left, right) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vishal2612200/agentpack",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.6",
|
|
4
4
|
"description": "npm launcher for the Python AgentPack CLI, a local context engine for AI coding agents that ranks relevant files and builds task-focused context packs.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://github.com/vishal2612200/agentpack#readme",
|
|
@@ -36,7 +36,6 @@
|
|
|
36
36
|
"prompt-context",
|
|
37
37
|
"mcp",
|
|
38
38
|
"ci",
|
|
39
|
-
"claude-code",
|
|
40
39
|
"codex",
|
|
41
40
|
"cursor",
|
|
42
41
|
"windsurf",
|
|
@@ -45,7 +44,6 @@
|
|
|
45
44
|
"llm",
|
|
46
45
|
"context",
|
|
47
46
|
"packing",
|
|
48
|
-
"claude",
|
|
49
47
|
"npm",
|
|
50
48
|
"cli"
|
|
51
49
|
]
|