Skip to content

Commit f5af8d4

Browse files
Wintersta7eWintersta7e
committed
chore: public-readiness audit — MIT license, community files, CI, sidebar fix
- Switch LICENSE from proprietary to MIT - Add CHANGELOG.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md - Add GitHub issue templates (bug report, feature request) - Add CI workflow (lint, typecheck, format, test) - Update README with badges, "Why AgentDeck?" section, community links - Update package.json with repository metadata, remove private flag - Update USER-GUIDE.md version and path fix - Fix sidebar CSS: templates section crushed when all sections expanded Co-Authored-By: Rooty
1 parent 57de9a4 commit f5af8d4

12 files changed

Lines changed: 456 additions & 14 deletions

File tree

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
name: Bug Report
3+
about: Report a bug in AgentDeck
4+
title: "[Bug] "
5+
labels: bug
6+
assignees: ''
7+
---
8+
9+
## Description
10+
11+
A clear description of what the bug is.
12+
13+
## Steps to Reproduce
14+
15+
1. Go to '...'
16+
2. Click on '...'
17+
3. See error
18+
19+
## Expected Behavior
20+
21+
What you expected to happen.
22+
23+
## Actual Behavior
24+
25+
What actually happened.
26+
27+
## Environment
28+
29+
- **AgentDeck version**: (e.g. 4.6.0)
30+
- **Windows version**: (e.g. Windows 11 23H2)
31+
- **WSL distro**: (e.g. Ubuntu 24.04)
32+
- **Node.js version**: (e.g. 22.12.0)
33+
- **Agent(s) involved**: (e.g. Claude Code, Codex)
34+
35+
## Screenshots
36+
37+
If applicable, add screenshots to help explain the problem.
38+
39+
## Additional Context
40+
41+
Any other context about the problem.

‎.github/ISSUE_TEMPLATE/feature_request.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
name: Feature Request
3+
about: Suggest a new feature for AgentDeck
4+
title: "[Feature] "
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
## Problem
10+
11+
What problem does this feature solve? Is it related to a frustration?
12+
13+
## Proposed Solution
14+
15+
A clear description of what you'd like to happen.
16+
17+
## Alternatives Considered
18+
19+
Any alternative solutions or features you've considered.
20+
21+
## Additional Context
22+
23+
Any other context, mockups, or examples.

‎.github/workflows/ci.yml‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
9+
jobs:
10+
lint-and-test:
11+
runs-on: ubuntu-latest
12+
13+
strategy:
14+
matrix:
15+
node-version: [22]
16+
17+
steps:
18+
- uses: actions/checkout@v4
19+
20+
- name: Use Node.js ${{ matrix.node-version }}
21+
uses: actions/setup-node@v4
22+
with:
23+
node-version: ${{ matrix.node-version }}
24+
cache: 'npm'
25+
26+
- name: Install dependencies
27+
run: npm ci
28+
29+
- name: Lint
30+
run: npm run lint
31+
32+
- name: Type check
33+
run: npm run typecheck
34+
35+
- name: Format check
36+
run: npm run format:check
37+
38+
- name: Test
39+
run: npm test

‎CHANGELOG.md‎

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
# Changelog
2+
3+
All notable changes to AgentDeck will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [4.6.0] - 2026-03-27
9+
10+
### Added
11+
- Codex skill discovery — scans projects for SKILL.md files with YAML frontmatter, TTL-cached
12+
- Project metadata refresh on IPC
13+
- Agent updater safety: binary verification, npm bin symlink auto-repair, rollback on failure
14+
15+
### Fixed
16+
- Stale package names in agent updater
17+
- UX audit: 26/27 issues resolved (welcome card, terminal context menu, a11y, focus traps, toasts, skeleton loaders, validation, breadcrumbs, node duplication, empty states)
18+
19+
### Changed
20+
- 499 tests (up from 436)
21+
22+
## [4.5.0] - 2026-03-25
23+
24+
### Added
25+
- Conditional branching — `condition` node type with exit code and output match modes
26+
- Loop/retry — loop-back edges with max iterations, per-node retry with configurable delay
27+
- Workflow variables — `{{VAR}}` substitution with typed pre-run dialog
28+
- Import/export — `.agentdeck-workflow.json` bundles with role remapping
29+
- Workflow clone — deep copy with new UUID
30+
- Execution history — per-run summaries with node timing, error tails, History tab
31+
- 5 new seed workflows (12 total): Test Coverage, Dependency Update, Documentation Pass, Performance Audit, Release Prep
32+
33+
### Changed
34+
- Engine rewrite: tier-based scheduler replaced with edge-activation scheduler (ready queue, pending edge counts, skip propagation, loop subgraph reset)
35+
- God-class refactor: `appStore.ts` split into 6 Zustand slices; workflow engine split into 3 files; workflow editor split into 3 files
36+
- ESLint tightened: `eqeqeq`, `no-console`, `no-eval`, `react-hooks/exhaustive-deps` promoted to error, `--max-warnings=0`
37+
- TypeScript: added `noImplicitOverride`
38+
- 436 tests (up from 348)
39+
40+
### Fixed
41+
- 5 npm dependency vulnerabilities
42+
- Codex `-C` flag and `--skip-git-repo-check` support
43+
- WF-1 through WF-15 (signal exit codes, truncated output buffer, scheduler double-complete, loop subgraph reset bug)
44+
45+
## [4.4.0] - 2026-03-22
46+
47+
### Added
48+
- Test coverage expansion: 293 to 348 tests across 32 files
49+
- IPC split into 6 modules
50+
- `terminal-utils.ts` extraction (pure functions)
51+
- Portability fixes P1-P6
52+
53+
### Fixed
54+
- TERM-12 through TERM-20 (post-refactor terminal issues)
55+
56+
## [4.3.0] - 2026-03-20
57+
58+
### Fixed
59+
- Terminal scroll and formatting fixes (5 tasks)
60+
- TERM-1 through TERM-11 across 3 review rounds (4-way review, 11 issues found, 9 fixed)
61+
62+
## [4.2.0] - 2026-03-18
63+
64+
### Changed
65+
- Architecture splits: `workflow-seeds.ts`, `store-seeds.ts`, `agent-detector.ts`, `workflow-utils.ts`, `ThemeSubmenu.tsx`, `AgentsSubmenu.tsx`
66+
67+
### Fixed
68+
- 59 code review fixes across 2 rounds (security, memory, performance, bugs, error handling)
69+
70+
## [4.1.0] - 2026-03-16
71+
72+
### Added
73+
- 7 seed workflows (Codex-focused)
74+
- 293 tests
75+
76+
## [4.0.0] - 2026-03-14
77+
78+
### Changed
79+
- Fusion UI redesign
80+
- Migrated all icons to Lucide React (tree-shakeable SVGs)
81+
- Full code review: 38 fixes
82+
- Hardened security: `sandbox: true` on BrowserWindow
83+
84+
### Added
85+
- 286 tests
86+
87+
## [3.0.0] - 2026-03-01
88+
89+
### Added
90+
- Workflow engine with visual node-graph editor
91+
- Polymorphic tabs (sessions + workflows)
92+
- Command palette with fuzzy search
93+
- Terminal performance optimizations
94+
- WSL resilience (retry, cold-boot handling)
95+
- Bare terminal sessions
96+
- 250 tests
97+
98+
## [2.0.0] - 2026-02-15
99+
100+
### Added
101+
- 8 themes (4 dark + 4 light) with view transitions
102+
- 16 seed prompt templates
103+
104+
## [1.0.0] - 2026-02-01
105+
106+
### Added
107+
- Initial release
108+
- Multi-agent terminal management (7 agents)
109+
- Project management with WSL path support
110+
- Split terminal views (1/2/3 panes)
111+
- Terminal caching and state preservation
112+
- Prompt template system
113+
- electron-store persistence

‎CODE_OF_CONDUCT.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, religion, or sexual identity
10+
and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment for our
18+
community include:
19+
20+
* Demonstrating empathy and kindness toward other people
21+
* Being respectful of differing opinions, viewpoints, and experiences
22+
* Giving and gracefully accepting constructive feedback
23+
* Accepting responsibility and apologizing to those affected by our mistakes,
24+
and learning from the experience
25+
* Focusing on what is best not just for us as individuals, but for the
26+
overall community
27+
28+
Examples of unacceptable behavior include:
29+
30+
* Trolling, insulting or derogatory comments, and personal or political attacks
31+
* Public or private harassment
32+
* Publishing others' private information without their explicit permission
33+
* Other conduct which could reasonably be considered inappropriate in a
34+
professional setting
35+
36+
## Enforcement Responsibilities
37+
38+
Community leaders are responsible for clarifying and enforcing our standards of
39+
acceptable behavior and will take appropriate and fair corrective action in
40+
response to any behavior that they deem inappropriate, threatening, offensive,
41+
or harmful.
42+
43+
## Scope
44+
45+
This Code of Conduct applies within all community spaces, and also applies when
46+
an individual is officially representing the community in public spaces.
47+
48+
## Enforcement
49+
50+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
51+
reported to the project maintainers via [GitHub Issues](https://github.com/Wintersta7e/agentdeck/issues).
52+
53+
All complaints will be reviewed and investigated promptly and fairly.
54+
55+
## Attribution
56+
57+
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
58+
version 2.0.

‎CONTRIBUTING.md‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
# Contributing to AgentDeck
2+
3+
Thanks for your interest in contributing to AgentDeck!
4+
5+
## Getting Started
6+
7+
1. Fork the repository
8+
2. Clone your fork
9+
3. Install dependencies:
10+
```bash
11+
npm install --no-bin-links
12+
```
13+
4. Start the dev server:
14+
```bash
15+
npm run dev
16+
```
17+
18+
## Prerequisites
19+
20+
- Windows 10/11 with WSL2 (Ubuntu recommended)
21+
- Node.js 22+
22+
- At least one AI coding agent installed in WSL
23+
24+
## Code Standards
25+
26+
- **TypeScript strict mode** — all source files are `.ts`/`.tsx`
27+
- **ESLint** — zero-warning policy (`npm run lint`)
28+
- **Prettier** — consistent formatting (`npm run format`)
29+
- **Vitest** — tests run with `npm test`
30+
31+
## Before Submitting a PR
32+
33+
1. Run the full lint check: `npm run lint`
34+
2. Run all tests: `npm test`
35+
3. Run the type checker: `npm run typecheck`
36+
4. Ensure zero warnings and all tests pass
37+
38+
## Commit Messages
39+
40+
- Use imperative mood ("Add feature" not "Added feature")
41+
- Keep the first line under 72 characters
42+
- Reference issues where applicable
43+
44+
## Pull Requests
45+
46+
1. Create a feature branch from `main`
47+
2. Make your changes with clear, focused commits
48+
3. Ensure all checks pass (lint, tests, typecheck)
49+
4. Open a PR against `main` with a clear description of what and why
50+
51+
## Architecture
52+
53+
See the [User Guide](./docs/USER-GUIDE.md) for feature documentation.
54+
55+
Key constraints:
56+
57+
- `node-pty` runs in the main process only (native bindings)
58+
- Context isolation is always on (`contextIsolation: true`, `nodeIntegration: false`, `sandbox: true`)
59+
- All IPC goes through `contextBridge` — renderer never imports Node modules
60+
- WSL paths only for project paths
61+
- All colors come from CSS custom properties in `tokens.css` — never hardcode colors
62+
63+
## Reporting Issues
64+
65+
- Use [GitHub Issues](../../issues) for bugs and feature requests
66+
- Include steps to reproduce for bugs
67+
- Check existing issues before creating new ones
68+
69+
## Security
70+
71+
See [SECURITY.md](./SECURITY.md) for reporting security vulnerabilities.

‎LICENSE‎

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,21 @@
1-
Copyright (c) 2025-2026 Wintersta7e. All rights reserved.
1+
MIT License
22

3-
This software and associated documentation files (the "Software") are the
4-
exclusive property of the copyright holder. No part of this Software may be
5-
used, copied, modified, merged, published, distributed, sublicensed, or sold
6-
without the prior written permission of the copyright holder.
3+
Copyright (c) 2025-2026 Wintersta7e
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
714

815
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
916
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
1017
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
11-
COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
12-
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
13-
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

0 commit comments

Comments
 (0)