@the-agenticflow/openflows 0.1.5 → 0.1.8-dev.230.5aa03a0
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/bin/openflows-dashboard.js +1 -1
- package/bin/openflows-setup.js +1 -1
- package/bin/openflows.js +4 -286
- package/package.json +2 -12
- package/scripts/install.js +47 -209
- package/.env.example +0 -60
- package/README.md +0 -217
- package/bin/LICENSE +0 -21
- package/bin/README.md +0 -535
- package/bin/agentflow-bin +0 -0
- package/bin/agentflow-dashboard-bin +0 -0
- package/bin/agentflow-doctor-bin +0 -0
- package/bin/agentflow-setup-bin +0 -0
- package/bin/orchestration/agent/agents/forge.agent.md +0 -110
- package/bin/orchestration/agent/agents/lore.agent.md +0 -27
- package/bin/orchestration/agent/agents/nexus.agent.md +0 -201
- package/bin/orchestration/agent/agents/sentinel.agent.md +0 -96
- package/bin/orchestration/agent/agents/vessel.agent.md +0 -38
- package/bin/orchestration/agent/registry.json +0 -10
- package/bin/orchestration/agent/standards/CODING.md +0 -22
- package/bin/orchestration/agent/standards/REVIEW.md +0 -15
- package/bin/orchestration/agent/standards/SECURITY.md +0 -72
- package/bin/orchestration/plugin/commands/assign.md +0 -45
- package/bin/orchestration/plugin/commands/check-ci.md +0 -26
- package/bin/orchestration/plugin/commands/document-pr.md +0 -32
- package/bin/orchestration/plugin/commands/gate-approve.md +0 -39
- package/bin/orchestration/plugin/commands/handoff.md +0 -75
- package/bin/orchestration/plugin/commands/merge.md +0 -47
- package/bin/orchestration/plugin/commands/plan.md +0 -66
- package/bin/orchestration/plugin/commands/segment-done.md +0 -50
- package/bin/orchestration/plugin/commands/status-check.md +0 -28
- package/bin/orchestration/plugin/commands/status.md +0 -94
- package/bin/orchestration/plugin/commands/update-changelog.md +0 -37
- package/bin/orchestration/plugin/hooks/forge/post_write_lint.sh +0 -76
- package/bin/orchestration/plugin/hooks/forge/pre_bash_guard.sh +0 -81
- package/bin/orchestration/plugin/hooks/forge/pre_compact_handoff.sh +0 -28
- package/bin/orchestration/plugin/hooks/forge/pre_write_check.sh +0 -77
- package/bin/orchestration/plugin/hooks/forge/session_start.sh +0 -59
- package/bin/orchestration/plugin/hooks/forge/stop_require_artifact.sh +0 -75
- package/bin/orchestration/plugin/hooks/lore/session-start.sh +0 -13
- package/bin/orchestration/plugin/hooks/nexus/init-session.sh +0 -23
- package/bin/orchestration/plugin/hooks/nexus/log-decision.sh +0 -10
- package/bin/orchestration/plugin/hooks/sentinel/post_write_validate.sh +0 -59
- package/bin/orchestration/plugin/hooks/sentinel/pre_bash_readonly_guard.sh +0 -107
- package/bin/orchestration/plugin/hooks/sentinel/session_start.sh +0 -74
- package/bin/orchestration/plugin/hooks/sentinel/stop_require_eval.sh +0 -57
- package/bin/orchestration/plugin/hooks/vessel/log-merge-status.sh +0 -7
- package/bin/orchestration/plugin/hooks/vessel/session-start.sh +0 -14
- package/bin/orchestration/plugin/mcp/mcp.json.template +0 -26
- package/bin/orchestration/plugin/plugin.json +0 -66
- package/bin/orchestration/plugin/skills/forge-algorithmic-art.md +0 -24
- package/bin/orchestration/plugin/skills/forge-canvas-design.md +0 -25
- package/bin/orchestration/plugin/skills/forge-coding.md +0 -161
- package/bin/orchestration/plugin/skills/forge-frontend-design.md +0 -30
- package/bin/orchestration/plugin/skills/forge-mcp-builder.md +0 -37
- package/bin/orchestration/plugin/skills/forge-planning.md +0 -102
- package/bin/orchestration/plugin/skills/forge-skill-creator.md +0 -25
- package/bin/orchestration/plugin/skills/forge-web-artifacts-builder.md +0 -29
- package/bin/orchestration/plugin/skills/lore-brand-guidelines.md +0 -33
- package/bin/orchestration/plugin/skills/lore-changelog.md +0 -69
- package/bin/orchestration/plugin/skills/lore-doc-coauthoring.md +0 -33
- package/bin/orchestration/plugin/skills/lore-documentation.md +0 -57
- package/bin/orchestration/plugin/skills/lore-docx.md +0 -20
- package/bin/orchestration/plugin/skills/lore-pdf.md +0 -20
- package/bin/orchestration/plugin/skills/lore-pptx.md +0 -23
- package/bin/orchestration/plugin/skills/lore-theme-factory.md +0 -20
- package/bin/orchestration/plugin/skills/lore-xlsx.md +0 -20
- package/bin/orchestration/plugin/skills/nexus-doc-coauthoring.md +0 -21
- package/bin/orchestration/plugin/skills/nexus-internal-comms.md +0 -28
- package/bin/orchestration/plugin/skills/nexus-orchestration.md +0 -63
- package/bin/orchestration/plugin/skills/nexus-skill-creator.md +0 -15
- package/bin/orchestration/plugin/skills/nexus-slack-gif-creator.md +0 -21
- package/bin/orchestration/plugin/skills/nexus-triage.md +0 -56
- package/bin/orchestration/plugin/skills/nexus-xlsx.md +0 -20
- package/bin/orchestration/plugin/skills/sentinel-algorithmic-art.md +0 -20
- package/bin/orchestration/plugin/skills/sentinel-criteria.md +0 -115
- package/bin/orchestration/plugin/skills/sentinel-frontend-design.md +0 -20
- package/bin/orchestration/plugin/skills/sentinel-review.md +0 -124
- package/bin/orchestration/plugin/skills/sentinel-web-artifacts-builder.md +0 -20
- package/bin/orchestration/plugin/skills/sentinel-webapp-testing.md +0 -34
- package/bin/orchestration/plugin/skills/shared-claude-api.md +0 -25
- package/bin/orchestration/plugin/skills/vessel-ci-gate.md +0 -68
- package/bin/orchestration/plugin/skills/vessel-internal-comms.md +0 -20
- package/bin/orchestration/plugin/skills/vessel-mcp-builder.md +0 -21
- package/bin/orchestration/plugin/skills/vessel-merge-protocol.md +0 -113
- package/bin/orchestration/plugin/skills/vessel-pdf.md +0 -20
- package/bin/orchestration/plugin/skills/vessel-webapp-testing.md +0 -34
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: mcp-builder
|
|
3
|
-
description: Skilled management and extension of the deployment automation MCP environment.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# VESSEL Infrastructure MCP Skill
|
|
7
|
-
|
|
8
|
-
Use this skill to maintain and extend the MCP servers used for deployment automation and monitoring.
|
|
9
|
-
|
|
10
|
-
## Focus Areas
|
|
11
|
-
|
|
12
|
-
- **Transport Reliability**: Ensure Stdio/SSE connections to deployment tools are stable.
|
|
13
|
-
- **Tool Mapping**: Correctly map CLI tools (Docker, K8s, Terraform) to MCP tools.
|
|
14
|
-
- **Environment Safety**: Ensure MCP tools have minimal necessary permissions for the target environment.
|
|
15
|
-
- **Monitoring Tools**: Build tools for retrieving logs and metrics into the AgentFlow context.
|
|
16
|
-
|
|
17
|
-
## Workflow
|
|
18
|
-
|
|
19
|
-
1. Identify missing infrastructure visibility.
|
|
20
|
-
2. Direct Forge or self-implement a new MCP tool/resource.
|
|
21
|
-
3. Verify tool safety and reliability in a staging environment.
|
|
@@ -1,113 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: merge-protocol
|
|
3
|
-
description: Protocol for safely merging approved PRs
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Merge Protocol Skill
|
|
7
|
-
|
|
8
|
-
## Pre-Merge Checklist
|
|
9
|
-
|
|
10
|
-
Before merging, verify:
|
|
11
|
-
- [ ] CI status: success
|
|
12
|
-
- [ ] SENTINEL approval: final-review.md exists with APPROVED
|
|
13
|
-
- [ ] No merge conflicts
|
|
14
|
-
- [ ] Branch up to date with main (or rebased)
|
|
15
|
-
|
|
16
|
-
## Merge Process
|
|
17
|
-
|
|
18
|
-
### Step 1: Fetch Latest
|
|
19
|
-
```bash
|
|
20
|
-
git fetch origin main
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
### Step 2: Check Divergence
|
|
24
|
-
```bash
|
|
25
|
-
BEHIND=$(git rev-list --count HEAD..origin/main)
|
|
26
|
-
if [ "$BEHIND" -gt 0 ]; then
|
|
27
|
-
# Need rebase or merge
|
|
28
|
-
fi
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
### Step 3: Merge
|
|
32
|
-
Use `merge_pr` MCP tool with:
|
|
33
|
-
- Merge method: `squash` (recommended) or `merge`
|
|
34
|
-
- Commit message: From SENTINEL's PR description
|
|
35
|
-
|
|
36
|
-
### Step 4: Verify
|
|
37
|
-
- Confirm merge completed
|
|
38
|
-
- Confirm branch deleted (optional)
|
|
39
|
-
|
|
40
|
-
### Step 5: Sync Active Worktrees
|
|
41
|
-
|
|
42
|
-
After a successful merge into main, **all active FORGE worktrees MUST be rebased**
|
|
43
|
-
onto the updated main to prevent drift and merge conflicts.
|
|
44
|
-
|
|
45
|
-
**Policy:** No branch may fall behind main. All branches must be at main or ahead of main.
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
# Fetch the latest main (now including the merge we just performed)
|
|
49
|
-
git fetch origin main
|
|
50
|
-
|
|
51
|
-
# Sync every active worktree
|
|
52
|
-
for wt in $(git worktree list --porcelain | grep "^worktree" | cut -d' ' -f2); do
|
|
53
|
-
BRANCH=$(git -C "$wt" branch --show-current)
|
|
54
|
-
if [ "$BRANCH" != "main" ] && [ -n "$BRANCH" ]; then
|
|
55
|
-
BEHIND=$(git -C "$wt" rev-list --count "HEAD..origin/main" 2>/dev/null || echo "0")
|
|
56
|
-
if [ "$BEHIND" -gt 0 ]; then
|
|
57
|
-
echo "Syncing worktree $wt ($BRANCH) — $BEHIND commits behind main"
|
|
58
|
-
git -C "$wt" rebase origin/main
|
|
59
|
-
if [ $? -ne 0 ]; then
|
|
60
|
-
git -C "$wt" rebase --abort
|
|
61
|
-
echo "CONFLICT in $wt on branch $BRANCH — requires manual resolution"
|
|
62
|
-
# Report conflict to NEXUS
|
|
63
|
-
fi
|
|
64
|
-
else
|
|
65
|
-
echo "Worktree $wt ($BRANCH) is up to date"
|
|
66
|
-
fi
|
|
67
|
-
fi
|
|
68
|
-
done
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
Alternatively, use the dedicated sync script:
|
|
72
|
-
```bash
|
|
73
|
-
bash scripts/sync-worktrees.sh
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
**Conflict handling:**
|
|
77
|
-
- If rebase conflicts, **abort immediately** — do NOT attempt auto-resolution
|
|
78
|
-
- Report the conflict to NEXUS with the worktree path and branch name
|
|
79
|
-
- Set the affected worker's STATUS.json to `BLOCKED` with reason `REBASE_CONFLICT`
|
|
80
|
-
- A human or fresh FORGE instance must resolve the conflict
|
|
81
|
-
|
|
82
|
-
### Step 6: Report
|
|
83
|
-
- Emit merge event
|
|
84
|
-
- Update shared store with merge status
|
|
85
|
-
- Include worktree sync results in the report
|
|
86
|
-
|
|
87
|
-
## Merge Methods
|
|
88
|
-
|
|
89
|
-
| Method | Use When |
|
|
90
|
-
|--------|----------|
|
|
91
|
-
| `squash` | Single logical change (recommended) |
|
|
92
|
-
| `merge` | Multiple commits should be preserved |
|
|
93
|
-
| `rebase` | Linear history preferred |
|
|
94
|
-
|
|
95
|
-
## Post-Merge
|
|
96
|
-
|
|
97
|
-
1. **Sync**: Rebase all active worktrees onto updated main (Step 5)
|
|
98
|
-
2. **Cleanup**: Remove worktree for the merged branch only
|
|
99
|
-
3. **Notify**: Emit event for NEXUS (include sync results)
|
|
100
|
-
4. **Update**: Set worker slot to Idle
|
|
101
|
-
|
|
102
|
-
## Failure Handling
|
|
103
|
-
|
|
104
|
-
If merge fails:
|
|
105
|
-
1. Check for conflicts
|
|
106
|
-
2. Report to NEXUS with `deploy_failed`
|
|
107
|
-
3. Do NOT attempt to resolve conflicts automatically
|
|
108
|
-
|
|
109
|
-
If worktree sync fails (rebase conflict):
|
|
110
|
-
1. Abort the rebase immediately
|
|
111
|
-
2. Report to NEXUS with worktree path and branch name
|
|
112
|
-
3. Set affected worker STATUS.json to `BLOCKED` with reason `REBASE_CONFLICT`
|
|
113
|
-
4. Do NOT attempt to resolve conflicts automatically — assign a fresh FORGE or human
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: pdf
|
|
3
|
-
description: Generating formal, secure reports for deployment cycles and infrastructure mapping.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# VESSEL Infrastructure Reporting Skill
|
|
7
|
-
|
|
8
|
-
Use this skill to generate tamper-proof, high-quality reports on infrastructure state and deployment history.
|
|
9
|
-
|
|
10
|
-
## Reporting Types
|
|
11
|
-
|
|
12
|
-
- **Infrastructure Audit**: PDF mapping of current cloud resources and security groups.
|
|
13
|
-
- **Deployment Sign-off**: Formal PDF certificate of successful deployment, including QA pass logs.
|
|
14
|
-
- **Security Scans**: Summarized PDF reports of vulnerability scans performed during CI/CD.
|
|
15
|
-
|
|
16
|
-
## Requirements
|
|
17
|
-
|
|
18
|
-
- Professional, objective formatting.
|
|
19
|
-
- Inclusion of cryptographic hashes or signatures where required.
|
|
20
|
-
- Clear, scannable summaries for architectural review.
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: webapp-testing
|
|
3
|
-
description: Toolkit for interacting with and testing local web applications using Playwright.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Web Application Testing Skill
|
|
7
|
-
|
|
8
|
-
Use this skill to verify frontend functionality, debug UI behavior, and capture browser state for evaluation or deployment verification.
|
|
9
|
-
|
|
10
|
-
## Workflow
|
|
11
|
-
|
|
12
|
-
1. **Reconnaissance**:
|
|
13
|
-
- Navigate to the local server URL.
|
|
14
|
-
- Wait for `networkidle` state to ensure JS execution is complete.
|
|
15
|
-
- Inspect the rendered DOM or take a full-page screenshot.
|
|
16
|
-
|
|
17
|
-
2. **Identification**:
|
|
18
|
-
- Locate specific elements using descriptive selectors (`text=`, `role=`, CSS, or IDs).
|
|
19
|
-
- Use `page.locator()` and `all()` to discover interactive elements.
|
|
20
|
-
|
|
21
|
-
3. **Execution**:
|
|
22
|
-
- Write Playwright scripts to perform actions (click, type, navigate).
|
|
23
|
-
- Verify assertions and capture logs for debugging.
|
|
24
|
-
|
|
25
|
-
## Helper Pattern
|
|
26
|
-
|
|
27
|
-
When working with local servers, ensure the server is running correctly before beginning reconnaissance. If managing server lifecycles, wait for port availability.
|
|
28
|
-
|
|
29
|
-
## Best Practices
|
|
30
|
-
|
|
31
|
-
- **Synchronous Logic**: Use `playwright.sync_api` for cleaner script integration where applicable.
|
|
32
|
-
- **Headless Mode**: Always launch browsers in headless mode for server-side execution.
|
|
33
|
-
- **Waits**: Use `wait_for_selector` or specific network idle states instead of arbitrary timeouts.
|
|
34
|
-
- **Artifacts**: Capture screenshots and console logs to provide proof of verification.
|