agentflight 0.3.1 → 0.3.2
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/CHANGELOG.md +25 -0
- package/README.md +23 -1
- package/docs/agentflight_logo/icon.svg +25 -0
- package/docs/assets/agentflight-cli-demo.svg +101 -0
- package/package.json +4 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,31 @@
|
|
|
2
2
|
|
|
3
3
|
All notable AgentFlight changes are documented here.
|
|
4
4
|
|
|
5
|
+
## [0.3.2] - 2026-06-13
|
|
6
|
+
|
|
7
|
+
### Changed
|
|
8
|
+
|
|
9
|
+
- Added the official AgentFlight logo to the README.
|
|
10
|
+
- Added the Baseframe Labs AgentFlight website link near the top of the README.
|
|
11
|
+
- Added an animated CLI workflow preview before the 60-second workflow.
|
|
12
|
+
- Added a "Watch The Flow" section explaining start -> verify -> snapshot -> status -> report/replay/resume.
|
|
13
|
+
- Updated package homepage to the AgentFlight website page.
|
|
14
|
+
- Expanded packaged assets so npm README logo and animation references resolve.
|
|
15
|
+
|
|
16
|
+
### Documentation
|
|
17
|
+
|
|
18
|
+
- Updated launch notes with the AgentFlight logo reference.
|
|
19
|
+
- Updated development log with branding and README animation verification.
|
|
20
|
+
|
|
21
|
+
### Verification
|
|
22
|
+
|
|
23
|
+
- `npm run verify` passed.
|
|
24
|
+
- `npm run format:check` passed.
|
|
25
|
+
- `npm pack --dry-run` passed.
|
|
26
|
+
- `npm audit --audit-level=moderate` found `0 vulnerabilities`.
|
|
27
|
+
- ProjScan preflight passed.
|
|
28
|
+
- AgentLoopKit verification passed.
|
|
29
|
+
|
|
5
30
|
## [0.3.1] - 2026-06-13
|
|
6
31
|
|
|
7
32
|
### Changed
|
package/README.md
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
# AgentFlight
|
|
2
2
|
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://www.baseframelabs.com/apps/agentflight">
|
|
5
|
+
<img src="docs/agentflight_logo/icon.svg" alt="AgentFlight logo" width="112" />
|
|
6
|
+
</a>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
3
9
|
See what your coding agent did. Prove it works. Know what to do next.
|
|
4
10
|
|
|
5
11
|
AgentFlight is a local-first flight recorder for AI coding agents from Baseframe Labs. It sits around Codex, Claude Code, Cursor, Windsurf, Gemini CLI, Aider, OpenCode, and similar tools so you can review the session instead of guessing what happened.
|
|
6
12
|
|
|
13
|
+
Website: [baseframelabs.com/apps/agentflight](https://www.baseframelabs.com/apps/agentflight)
|
|
14
|
+
|
|
7
15
|
AgentFlight helps you:
|
|
8
16
|
|
|
9
17
|
- start an AI coding session
|
|
@@ -14,7 +22,7 @@ AgentFlight helps you:
|
|
|
14
22
|
- generate a local replay timeline
|
|
15
23
|
- create a resume prompt for the next agent or reviewer
|
|
16
24
|
|
|
17
|
-
|
|
18
26
|
|
|
19
27
|
## 60-Second Workflow
|
|
20
28
|
|
|
@@ -43,6 +51,20 @@ What you get:
|
|
|
43
51
|
- `replay` writes a local HTML timeline you can open in a browser.
|
|
44
52
|
- `resume` writes a Codex/Claude-ready prompt for the next safe step.
|
|
45
53
|
|
|
54
|
+
## Watch The Flow
|
|
55
|
+
|
|
56
|
+
AgentFlight turns a loose AI-agent session into a local proof trail:
|
|
57
|
+
|
|
58
|
+
1. Start a session before you ask the coding agent to work.
|
|
59
|
+
2. Capture real verification output with `agentflight verify`.
|
|
60
|
+
3. Snapshot meaningful checkpoints.
|
|
61
|
+
4. Read `status` to see changed files, risk, proof, gaps, and next action.
|
|
62
|
+
5. Generate `report`, `replay`, and `resume` when the work is ready to review or hand off.
|
|
63
|
+
|
|
64
|
+
The replay artifact is a self-contained local HTML file:
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
|
|
46
68
|
## Why This Exists
|
|
47
69
|
|
|
48
70
|
AI coding agents move fast. After a few prompts, you can lose track of:
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512" role="img" aria-label="AgentFlight logo">
|
|
2
|
+
<title>AgentFlight logo</title>
|
|
3
|
+
<defs>
|
|
4
|
+
<linearGradient id="af-bg" x1="0" y1="0" x2="0" y2="1">
|
|
5
|
+
<stop offset="0" stop-color="#1B2042"/>
|
|
6
|
+
<stop offset="1" stop-color="#0C0F22"/>
|
|
7
|
+
</linearGradient>
|
|
8
|
+
<linearGradient id="af-rec" x1="0" y1="0" x2="1" y2="1">
|
|
9
|
+
<stop offset="0" stop-color="#8E8DF8"/>
|
|
10
|
+
<stop offset="1" stop-color="#5B5BEF"/>
|
|
11
|
+
</linearGradient>
|
|
12
|
+
</defs>
|
|
13
|
+
<rect x="0" y="0" width="512" height="512" rx="114" ry="114" fill="url(#af-bg)"/>
|
|
14
|
+
<!-- Flight recorder body: a rounded "black box" module -->
|
|
15
|
+
<rect x="108" y="156" width="296" height="200" rx="50" ry="50"
|
|
16
|
+
fill="none" stroke="url(#af-rec)" stroke-width="26"/>
|
|
17
|
+
<!-- Recorded session timeline that lifts into a proof check -->
|
|
18
|
+
<path d="M 156 286 H 270 L 292 312 L 360 232"
|
|
19
|
+
fill="none" stroke="#FFFFFF" stroke-width="24"
|
|
20
|
+
stroke-linecap="round" stroke-linejoin="round"/>
|
|
21
|
+
<!-- Event markers along the timeline -->
|
|
22
|
+
<circle cx="180" cy="286" r="14" fill="#8E8DF8"/>
|
|
23
|
+
<circle cx="216" cy="286" r="14" fill="#7A79F4"/>
|
|
24
|
+
<circle cx="252" cy="286" r="14" fill="#5B5BEF"/>
|
|
25
|
+
</svg>
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="680" viewBox="0 0 1200 680" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">AgentFlight CLI workflow animation</title>
|
|
3
|
+
<desc id="desc">Animated terminal-style demo showing AgentFlight start, verify, snapshot, and status output for an AI coding session.</desc>
|
|
4
|
+
<style>
|
|
5
|
+
.bg { fill: #0f111a; }
|
|
6
|
+
.bar { fill: #171a24; }
|
|
7
|
+
.red { fill: #ff5f57; }
|
|
8
|
+
.yellow { fill: #ffbd2e; }
|
|
9
|
+
.green { fill: #28c840; }
|
|
10
|
+
.text { fill: #e8ecf3; font: 22px ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; }
|
|
11
|
+
.muted { fill: #9aa4b2; font: 20px ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; }
|
|
12
|
+
.cmd { fill: #7dd3fc; font: 22px ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; }
|
|
13
|
+
.ok { fill: #86efac; font: 22px ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; }
|
|
14
|
+
.warn { fill: #fbbf24; font: 22px ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; }
|
|
15
|
+
.panel {
|
|
16
|
+
opacity: 0;
|
|
17
|
+
animation-duration: 12s;
|
|
18
|
+
animation-iteration-count: infinite;
|
|
19
|
+
animation-timing-function: ease-in-out;
|
|
20
|
+
}
|
|
21
|
+
.p1 { animation-name: panel1; }
|
|
22
|
+
.p2 { animation-name: panel2; }
|
|
23
|
+
.p3 { animation-name: panel3; }
|
|
24
|
+
@keyframes panel1 {
|
|
25
|
+
0%, 27% { opacity: 1; }
|
|
26
|
+
33%, 100% { opacity: 0; }
|
|
27
|
+
}
|
|
28
|
+
@keyframes panel2 {
|
|
29
|
+
0%, 30% { opacity: 0; }
|
|
30
|
+
36%, 60% { opacity: 1; }
|
|
31
|
+
66%, 100% { opacity: 0; }
|
|
32
|
+
}
|
|
33
|
+
@keyframes panel3 {
|
|
34
|
+
0%, 63% { opacity: 0; }
|
|
35
|
+
69%, 94% { opacity: 1; }
|
|
36
|
+
100% { opacity: 0; }
|
|
37
|
+
}
|
|
38
|
+
.cursor {
|
|
39
|
+
animation: blink 1s steps(2, start) infinite;
|
|
40
|
+
}
|
|
41
|
+
@keyframes blink {
|
|
42
|
+
0%, 45% { opacity: 1; }
|
|
43
|
+
46%, 100% { opacity: 0; }
|
|
44
|
+
}
|
|
45
|
+
</style>
|
|
46
|
+
|
|
47
|
+
<rect class="bg" x="0" y="0" width="1200" height="680" rx="18" />
|
|
48
|
+
<rect class="bar" x="0" y="0" width="1200" height="54" rx="18" />
|
|
49
|
+
<circle class="red" cx="32" cy="27" r="9" />
|
|
50
|
+
<circle class="yellow" cx="62" cy="27" r="9" />
|
|
51
|
+
<circle class="green" cx="92" cy="27" r="9" />
|
|
52
|
+
<text class="muted" x="130" y="35">AgentFlight local flight recorder</text>
|
|
53
|
+
|
|
54
|
+
<g class="panel p1">
|
|
55
|
+
<text class="cmd" x="44" y="96">$ npx agentflight@latest start --task "Add password reset flow"</text>
|
|
56
|
+
<text class="text" x="44" y="146">AgentFlight started</text>
|
|
57
|
+
<text class="muted" x="44" y="196">Task:</text>
|
|
58
|
+
<text class="text" x="160" y="196">Add password reset flow</text>
|
|
59
|
+
<text class="muted" x="44" y="246">Session:</text>
|
|
60
|
+
<text class="text" x="160" y="246">af-20260613-add-password-reset-flow</text>
|
|
61
|
+
<text class="muted" x="44" y="296">Detected:</text>
|
|
62
|
+
<text class="text" x="70" y="342">Git branch: main</text>
|
|
63
|
+
<text class="text" x="70" y="386">Package manager: npm</text>
|
|
64
|
+
<text class="ok" x="70" y="430">ProjScan: available</text>
|
|
65
|
+
<text class="ok" x="70" y="474">AgentLoopKit: available</text>
|
|
66
|
+
<text class="warn" x="44" y="542">Suggested proof: npm test</text>
|
|
67
|
+
<text class="muted" x="44" y="600">Now run Codex, Claude Code, Cursor, or your coding agent normally.</text>
|
|
68
|
+
</g>
|
|
69
|
+
|
|
70
|
+
<g class="panel p2">
|
|
71
|
+
<text class="cmd" x="44" y="96">$ npx agentflight@latest verify -- npm test</text>
|
|
72
|
+
<text class="text" x="44" y="146">Verification recorded</text>
|
|
73
|
+
<text class="muted" x="44" y="196">Command:</text>
|
|
74
|
+
<text class="text" x="160" y="196">npm test</text>
|
|
75
|
+
<text class="muted" x="44" y="246">Status:</text>
|
|
76
|
+
<text class="ok" x="160" y="246">passed</text>
|
|
77
|
+
<text class="muted" x="44" y="296">Evidence:</text>
|
|
78
|
+
<text class="text" x="70" y="342">stdout: .agentflight/evidence/.../verification-1.stdout.txt</text>
|
|
79
|
+
<text class="text" x="70" y="386">stderr: .agentflight/evidence/.../verification-1.stderr.txt</text>
|
|
80
|
+
<text class="cmd" x="44" y="474">$ npx agentflight@latest snapshot --note "Initial implementation verified"</text>
|
|
81
|
+
<text class="text" x="44" y="524">Snapshot recorded</text>
|
|
82
|
+
<text class="text" x="70" y="570">Changed files: 3 Risk: medium Verification: 1 passed, 0 failed</text>
|
|
83
|
+
</g>
|
|
84
|
+
|
|
85
|
+
<g class="panel p3">
|
|
86
|
+
<text class="cmd" x="44" y="96">$ npx agentflight@latest status</text>
|
|
87
|
+
<text class="text" x="44" y="146">AgentFlight status</text>
|
|
88
|
+
<text class="muted" x="44" y="196">Task:</text>
|
|
89
|
+
<text class="text" x="160" y="196">Add password reset flow</text>
|
|
90
|
+
<text class="muted" x="44" y="246">Changed files:</text>
|
|
91
|
+
<text class="text" x="230" y="246">3</text>
|
|
92
|
+
<text class="muted" x="44" y="296">Changed areas:</text>
|
|
93
|
+
<text class="text" x="70" y="342">docs: docs/password-reset.md</text>
|
|
94
|
+
<text class="text" x="70" y="386">tests: tests/password-reset.test.js</text>
|
|
95
|
+
<text class="text" x="70" y="430">unknown: src/password-reset.ts</text>
|
|
96
|
+
<text class="warn" x="44" y="498">Risk: medium</text>
|
|
97
|
+
<text class="ok" x="44" y="548">Verification Evidence: 1 passed, 0 failed</text>
|
|
98
|
+
<text class="ok" x="44" y="598">Review readiness: Ready for review</text>
|
|
99
|
+
<text class="cmd cursor" x="44" y="642">Next action: agentflight report</text>
|
|
100
|
+
</g>
|
|
101
|
+
</svg>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentflight",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"description": "Local-first flight recorder for AI coding agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/cli.js",
|
|
@@ -12,6 +12,8 @@
|
|
|
12
12
|
"dist",
|
|
13
13
|
"README.md",
|
|
14
14
|
"CHANGELOG.md",
|
|
15
|
+
"docs/agentflight_logo/icon.svg",
|
|
16
|
+
"docs/assets/agentflight-cli-demo.svg",
|
|
15
17
|
"docs/assets/agentflight-replay-timeline.png",
|
|
16
18
|
"docs/development/dogfooding.md",
|
|
17
19
|
"docs/development/release.md",
|
|
@@ -58,7 +60,7 @@
|
|
|
58
60
|
"bugs": {
|
|
59
61
|
"url": "https://github.com/abhiyoheswaran1/AgentFlight/issues"
|
|
60
62
|
},
|
|
61
|
-
"homepage": "https://
|
|
63
|
+
"homepage": "https://www.baseframelabs.com/apps/agentflight",
|
|
62
64
|
"devDependencies": {
|
|
63
65
|
"@eslint/js": "^10.0.1",
|
|
64
66
|
"@types/node": "^25.9.3",
|