Skip to content

Commit 27cac77

Browse files
blackboxprogrammingblackboxprogramming
committed
agent: deploy repo-improver
1 parent d4db9ce commit 27cac77

1 file changed

Lines changed: 281 additions & 0 deletions

File tree

‎.github/workflows/agent-repo-improver.yml‎

Lines changed: 281 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,281 @@
1+
# .github/workflows/agent-repo-improver.yml
2+
# Self-improving agent that audits and fixes repos across all orgs
3+
# Runs daily — finds repos missing README, LICENSE, .gitignore, workflows
4+
# Creates PRs to fix them automatically
5+
6+
name: "Agent: Repo Improver"
7+
8+
on:
9+
schedule:
10+
- cron: '0 6 * * *' # Daily 6am UTC
11+
workflow_dispatch:
12+
inputs:
13+
target_org:
14+
description: 'Target org (or "all")'
15+
required: false
16+
default: 'BlackRoad-OS-Inc'
17+
dry_run:
18+
description: 'Dry run (no changes)'
19+
required: false
20+
default: 'false'
21+
type: boolean
22+
max_repos:
23+
description: 'Max repos to process'
24+
required: false
25+
default: '20'
26+
27+
permissions:
28+
contents: write
29+
pull-requests: write
30+
issues: write
31+
32+
concurrency:
33+
group: repo-improver-${{ github.ref }}
34+
cancel-in-progress: true
35+
36+
env:
37+
DRY_RUN: ${{ inputs.dry_run || 'false' }}
38+
MAX_REPOS: ${{ inputs.max_repos || '20' }}
39+
40+
jobs:
41+
audit:
42+
name: "Audit Repos"
43+
runs-on: ubuntu-latest
44+
outputs:
45+
repos_to_fix: ${{ steps.audit.outputs.repos }}
46+
total_issues: ${{ steps.audit.outputs.total }}
47+
48+
steps:
49+
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
50+
51+
- name: Audit repositories
52+
id: audit
53+
uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
54+
with:
55+
script: |
56+
const targetOrg = '${{ inputs.target_org }}' || 'BlackRoad-OS-Inc';
57+
const maxRepos = parseInt('${{ env.MAX_REPOS }}');
58+
const orgs = targetOrg === 'all'
59+
? ['BlackRoad-OS-Inc','BlackRoad-OS','BlackRoad-AI','BlackRoad-Studio','BlackRoad-Education','BlackRoad-Security','BlackRoad-Labs','BlackRoad-Hardware','BlackRoad-Media','BlackRoad-Foundation','BlackRoad-Ventures','BlackRoad-Cloud','BlackRoad-Gov','BlackRoad-Archive','BlackRoad-Interactive','Blackbox-Enterprises']
60+
: [targetOrg];
61+
62+
const issues = [];
63+
64+
for (const org of orgs) {
65+
let page = 1;
66+
let repos = [];
67+
while (true) {
68+
const { data } = await github.rest.repos.listForOrg({ org, per_page: 100, page, type: 'all' });
69+
if (data.length === 0) break;
70+
repos = repos.concat(data.filter(r => !r.archived && !r.fork));
71+
page++;
72+
}
73+
74+
for (const repo of repos) {
75+
if (issues.length >= maxRepos) break;
76+
const fixes = [];
77+
78+
// Check README
79+
try {
80+
const { data: readme } = await github.rest.repos.getReadme({ owner: org, repo: repo.name });
81+
const content = Buffer.from(readme.content, 'base64').toString();
82+
if (content.length < 100) fixes.push('readme_stub');
83+
} catch {
84+
fixes.push('readme_missing');
85+
}
86+
87+
// Check LICENSE
88+
try {
89+
await github.rest.repos.getContent({ owner: org, repo: repo.name, path: 'LICENSE' });
90+
} catch {
91+
fixes.push('license_missing');
92+
}
93+
94+
// Check description
95+
if (!repo.description || repo.description.length < 10) {
96+
fixes.push('description_missing');
97+
}
98+
99+
// Check topics
100+
const { data: topicData } = await github.rest.repos.getAllTopics({ owner: org, repo: repo.name });
101+
if (!topicData.names || topicData.names.length === 0) {
102+
fixes.push('topics_missing');
103+
}
104+
105+
if (fixes.length > 0) {
106+
issues.push({ org, repo: repo.name, fixes, language: repo.language || 'unknown' });
107+
}
108+
}
109+
}
110+
111+
core.setOutput('repos', JSON.stringify(issues.slice(0, maxRepos)));
112+
core.setOutput('total', issues.length);
113+
console.log(`Found ${issues.length} repos needing fixes`);
114+
for (const i of issues.slice(0, 10)) {
115+
console.log(` ${i.org}/${i.repo}: ${i.fixes.join(', ')}`);
116+
}
117+
118+
fix:
119+
name: "Fix: ${{ matrix.repo }}"
120+
needs: audit
121+
if: needs.audit.outputs.total_issues != '0' && needs.audit.outputs.repos_to_fix != '[]'
122+
runs-on: ubuntu-latest
123+
strategy:
124+
matrix:
125+
include: ${{ fromJSON(needs.audit.outputs.repos_to_fix) }}
126+
max-parallel: 5
127+
fail-fast: false
128+
129+
steps:
130+
- name: Apply fixes
131+
if: env.DRY_RUN != 'true'
132+
uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
133+
with:
134+
script: |
135+
const org = '${{ matrix.org }}';
136+
const repo = '${{ matrix.repo }}';
137+
const fixes = ${{ toJSON(matrix.fixes) }};
138+
const language = '${{ matrix.language }}';
139+
140+
console.log(`Fixing ${org}/${repo}: ${fixes.join(', ')}`);
141+
142+
// Fix missing description
143+
if (fixes.includes('description_missing')) {
144+
const langDesc = {
145+
'JavaScript': 'JS/TS application',
146+
'TypeScript': 'TypeScript application',
147+
'Python': 'Python application',
148+
'Shell': 'Shell scripts and automation',
149+
'HTML': 'Web application',
150+
'Rust': 'Rust application',
151+
'Go': 'Go application',
152+
'unknown': 'BlackRoad OS component'
153+
};
154+
const desc = `${repo.replace(/-/g, ' ').replace(/\b\w/g, l => l.toUpperCase())} — ${langDesc[language] || 'BlackRoad OS component'}. Proprietary to BlackRoad OS, Inc.`;
155+
156+
await github.rest.repos.update({ owner: org, repo, description: desc.substring(0, 350) });
157+
console.log(` Set description: ${desc.substring(0, 80)}...`);
158+
}
159+
160+
// Fix missing topics
161+
if (fixes.includes('topics_missing')) {
162+
const baseTags = ['blackroad', 'blackroad-os'];
163+
const langTags = {
164+
'JavaScript': ['javascript', 'nodejs'],
165+
'TypeScript': ['typescript', 'nodejs'],
166+
'Python': ['python'],
167+
'Shell': ['bash', 'shell', 'automation'],
168+
'HTML': ['html', 'web'],
169+
'Rust': ['rust'],
170+
'Go': ['golang']
171+
};
172+
const tags = [...baseTags, ...(langTags[language] || [])];
173+
174+
// Infer from repo name
175+
if (repo.includes('ai') || repo.includes('lucidia')) tags.push('ai');
176+
if (repo.includes('security') || repo.includes('audit')) tags.push('security');
177+
if (repo.includes('fleet') || repo.includes('pi')) tags.push('raspberry-pi');
178+
if (repo.includes('road')) tags.push('sovereign-infrastructure');
179+
180+
await github.rest.repos.replaceAllTopics({ owner: org, repo, names: [...new Set(tags)].slice(0, 20) });
181+
console.log(` Set topics: ${tags.join(', ')}`);
182+
}
183+
184+
// Fix missing LICENSE (add proprietary license)
185+
if (fixes.includes('license_missing')) {
186+
const license = `BlackRoad OS, Inc. — Proprietary License
187+
188+
Copyright (c) 2024-2026 BlackRoad OS, Inc. All Rights Reserved.
189+
190+
This software is proprietary to BlackRoad OS, Inc.
191+
Source code is publicly visible for transparency.
192+
Commercial use, forking, and redistribution are prohibited
193+
without written authorization from BlackRoad OS, Inc.
194+
195+
Contact: alexa@blackroad.io
196+
Website: https://blackroad.io
197+
`;
198+
try {
199+
await github.rest.repos.createOrUpdateFileContents({
200+
owner: org, repo, path: 'LICENSE',
201+
message: 'add proprietary LICENSE',
202+
content: Buffer.from(license).toString('base64'),
203+
committer: { name: 'BlackRoad Agent', email: 'agent@blackroad.io' }
204+
});
205+
console.log(' Added LICENSE');
206+
} catch (e) {
207+
console.log(` LICENSE skip: ${e.message}`);
208+
}
209+
}
210+
211+
// Fix stub README (< 100 chars)
212+
if (fixes.includes('readme_stub') || fixes.includes('readme_missing')) {
213+
const readme = `# ${repo}
214+
215+
**Proprietary Software — [BlackRoad OS, Inc.](https://github.com/BlackRoad-OS-Inc)**
216+
217+
${language !== 'unknown' ? `Built with ${language}.` : ''}
218+
219+
## About
220+
221+
Part of the BlackRoad OS ecosystem — sovereign infrastructure on self-hosted hardware.
222+
223+
## License
224+
225+
This software is proprietary to BlackRoad OS, Inc. Source code is publicly visible for transparency. Commercial use, forking, and redistribution are prohibited without written authorization.
226+
227+
---
228+
229+
**BlackRoad OS — Pave Tomorrow.**
230+
231+
*Copyright 2024-2026 BlackRoad OS, Inc. All Rights Reserved.*
232+
`;
233+
try {
234+
let sha;
235+
try {
236+
const { data } = await github.rest.repos.getContent({ owner: org, repo, path: 'README.md' });
237+
sha = data.sha;
238+
} catch {}
239+
240+
const params = {
241+
owner: org, repo, path: 'README.md',
242+
message: fixes.includes('readme_missing') ? 'add README' : 'improve stub README',
243+
content: Buffer.from(readme).toString('base64'),
244+
committer: { name: 'BlackRoad Agent', email: 'agent@blackroad.io' }
245+
};
246+
if (sha) params.sha = sha;
247+
248+
await github.rest.repos.createOrUpdateFileContents(params);
249+
console.log(' Fixed README');
250+
} catch (e) {
251+
console.log(` README skip: ${e.message}`);
252+
}
253+
}
254+
255+
report:
256+
name: "Summary Report"
257+
needs: [audit, fix]
258+
if: always()
259+
runs-on: ubuntu-latest
260+
261+
steps:
262+
- name: Post summary
263+
uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
264+
with:
265+
script: |
266+
const total = parseInt('${{ needs.audit.outputs.total_issues }}') || 0;
267+
const repos = JSON.parse('${{ needs.audit.outputs.repos_to_fix }}' || '[]');
268+
269+
const summary = `## Repo Improver Report
270+
271+
**Repos audited with issues:** ${total}
272+
**Repos fixed this run:** ${repos.length}
273+
274+
| Repo | Fixes Applied |
275+
|------|--------------|
276+
${repos.map(r => `| ${r.org}/${r.repo} | ${r.fixes.join(', ')} |`).join('\n')}
277+
278+
---
279+
*BlackRoad Autonomous Agent — Pave Tomorrow.*`;
280+
281+
await core.summary.addRaw(summary).write();

0 commit comments

Comments
 (0)