From 813fd7d6fbe303c461e0d0204d4b66fd4b7f85bb Mon Sep 17 00:00:00 2001 From: darkzOGx Date: Mon, 19 Oct 2026 23:32:28 -0500 Subject: [PATCH] chore: replace Lumen name with YouTube Automation Agent Use the project name consistently in the README, dashboard UI, setup wizard, package description, examples, and growth reports. The released v2.11.0 changelog entry is left as written. Co-Authored-By: Claude Opus 5.5 --- .env.example | 2 +- README.md | 30 +++++++++---------- assets/demo/README.md | 2 +- dashboard/app.js | 12 ++++---- dashboard/enhance.js | 8 ++--- dashboard/index.html | 8 ++--- dashboard/styles.css | 2 +- examples/README.md | 4 +-- package.json | 2 +- reports/growth/baseline-2026-08-18.md | 2 +- reports/growth/fork-census-2026-08-18.md | 2 +- .../growth/prelaunch-readiness-2026-08-18.md | 2 +- scripts/growth/snapshot-github.js | 4 +-- walkthrough.js | 2 +- 14 files changed, 41 insertions(+), 41 deletions(-) diff --git a/.env.example b/.env.example index 010bb454..3f317139 100644 --- a/.env.example +++ b/.env.example @@ -114,7 +114,7 @@ GENERATION_RETRY_BASE_MS=1000 # Optional anonymous activation milestones (OFF by default). # No telemetry is sent unless both values are explicitly configured. -# Payload: milestone name, timestamp, Lumen version, OS family, Node major, +# Payload: milestone name, timestamp, YouTube Automation Agent version, OS family, Node major, # and a random installation ID. Never includes channel, topic, title, keys, or files. # ANONYMOUS_TELEMETRY_ENABLED=false # ANONYMOUS_TELEMETRY_ENDPOINT=https://your-collector.example/events diff --git a/README.md b/README.md index 1b8a230e..b1277064 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ Before activating autonomous production, open **Production readiness** in the da AI image generation can incur a larger provider charge, so its live probe is a separate opt-in checkbox. Without that checkbox, image configuration is reported as verified, skipped, or using the built-in gradient fallback without making a paid image request. -AI video verification has its own **Include paid video probe** checkbox. When enabled, Lumen creates the provider's shortest supported test clip, records the external task and model, downloads and decodes the MP4, then removes the temporary asset. It never silently tries a second paid provider. +AI video verification has its own **Include paid video probe** checkbox. When enabled, YouTube Automation Agent creates the provider's shortest supported test clip, records the external task and model, downloads and decodes the MP4, then removes the temporary asset. It never silently tries a second paid provider. Results persist locally in SQLite with exact remediation steps. A recorded blocking failure stops autonomous generation and publishing until a later run passes; manual work remains available when readiness has never been checked or the last result is older than 24 hours. @@ -78,7 +78,7 @@ Results persist locally in SQLite with exact remediation steps. A recorded block Every generation stage writes a local SQLite checkpoint. If a provider times out or the application restarts, the dashboard shows the saved-stage count and the first incomplete stage. Choose **Resume** to continue from there, or select an earlier stage when you intentionally want to regenerate that stage and everything after it. Saved files are validated before reuse; missing artifacts are regenerated automatically. -Autonomous Operator runs preserve their research and editorial plan, so **Resume run** continues unfinished plan items instead of researching and generating completed videos again. Publishing remains fail-closed: if an upload may have reached YouTube but no video ID was returned, Lumen requires channel reconciliation before another upload attempt. +Autonomous Operator runs preserve their research and editorial plan, so **Resume run** continues unfinished plan items instead of researching and generating completed videos again. Publishing remains fail-closed: if an upload may have reached YouTube but no video ID was returned, YouTube Automation Agent requires channel reconciliation before another upload attempt. ### Repair one scene without starting over @@ -130,39 +130,39 @@ The optional external adapter uses a shell-free Python child process, sends cont - FFmpeg, installed automatically through `ffmpeg-static` - Python 3.9+ only when explicitly testing an external DarkzSEO checkout -Gemini offers free access for supported text and TTS usage. Gemini AI image generation currently requires paid-tier access; without an image provider, Lumen can assemble gradient-based visuals instead. +Gemini offers free access for supported text and TTS usage. Gemini AI image generation currently requires paid-tier access; without an image provider, YouTube Automation Agent can assemble gradient-based visuals instead. ### Run the Autonomous Channel Operator Open **Autonomous operator** in the dashboard and describe the channel outcome—not a task list. Set the objective, audience, content pillars, publishing cadence, success metric, and boundaries, then choose **Activate & run now**. -Lumen refreshes YouTube trend and configured-competitor signals, checks recent channel topics, creates an evidence-labeled editorial plan, and sends each planned video through strategy, script, thumbnail, SEO, production, and workflow management. Active strategies also guide scheduled generation at the requested weekly cadence. Operator runs, decisions, progress, and failures persist in SQLite and remain visible in the dashboard. +YouTube Automation Agent refreshes YouTube trend and configured-competitor signals, checks recent channel topics, creates an evidence-labeled editorial plan, and sends each planned video through strategy, script, thumbnail, SEO, production, and workflow management. Active strategies also guide scheduled generation at the requested weekly cadence. Operator runs, decisions, progress, and failures persist in SQLite and remain visible in the dashboard. By default, finished videos wait for factual review, media-rights confirmation, and approval. Once approved, the existing publishing agent schedules and uploads them. Turning on autonomy does not bypass those gates, and simulated videos still cannot publish. ### Close the performance loop -After publication, Lumen captures comparable 24-hour and 7-day performance snapshots. It evaluates CTR, retention, engagement, watch time, format, length, hook style, and title style against the channel's own history—not a universal view-count target. +After publication, YouTube Automation Agent captures comparable 24-hour and 7-day performance snapshots. It evaluates CTR, retention, engagement, watch time, format, length, hook style, and title style against the channel's own history—not a universal view-count target. Open **Analytics → What the agent learned** to review the evidence and confidence behind each recommendation. Pending or rejected recommendations never influence generation. Once you approve one, the next Autonomous Channel Operator run includes it as an explicit planning constraint. Simulated analytics fallbacks are stored as unverified and are never eligible for baselines or recommendations. -When an approved learning calls for better packaging, Lumen prepares a control plus title and thumbnail variants for new videos. Review Studio shows those options before approval; the selected combination is the only one handed to the publishing queue. Lumen does not silently swap live YouTube metadata. +When an approved learning calls for better packaging, YouTube Automation Agent prepares a control plus title and thumbnail variants for new videos. Review Studio shows those options before approval; the selected combination is the only one handed to the publishing queue. YouTube Automation Agent does not silently swap live YouTube metadata. ### Prove a growth recommendation Open **Analytics → Controlled Growth Experiments** after a video with approved-learning packaging variants is published. Create a draft plan with a 24–168 hour window per arm and a minimum-impressions threshold, review the exact title and thumbnail combinations, then separately approve and start the live test. -Lumen records a cumulative analytics sample before and after each arm and evaluates only the interval delta. Every arm must reach the configured impression and click floor. The leading CTR must clear a 95% evidence threshold without a material retention regression or traffic-source shift; otherwise the result is explicitly **inconclusive**. Simulated analytics never advance an experiment. +YouTube Automation Agent records a cumulative analytics sample before and after each arm and evaluates only the interval delta. Every arm must reach the configured impression and click floor. The leading CTR must clear a 95% evidence threshold without a material retention regression or traffic-source shift; otherwise the result is explicitly **inconclusive**. Simulated analytics never advance an experiment. -Arm rotations are limited to the plan you approved. After the final arm, Lumen restores the control title and thumbnail before presenting the result. Applying the winner is a separate confirmation; only then does the validated packaging pattern become an approved learning for future Autonomous Operator runs. Experiment state and evidence are stored in SQLite so restarts do not erase progress. +Arm rotations are limited to the plan you approved. After the final arm, YouTube Automation Agent restores the control title and thumbnail before presenting the result. Applying the winner is a separate confirmation; only then does the validated packaging pattern become an approved learning for future Autonomous Operator runs. Experiment state and evidence are stored in SQLite so restarts do not erase progress. ### Align the channel with outcomes and ROI The Autonomous Operator strategy can define a measurable primary outcome—views, watch hours, net subscribers, engagement rate, or estimated revenue—plus a numeric target, evidence window, monthly production budget, and currency. The existing free-text outcome context remains available for goals that need human nuance. -At each real analytics window, Lumen stores subscriber gains and losses, watch hours, monetization evidence when the channel exposes it, and known production costs from durable scene records. **Analytics → Outcome & ROI Studio** shows target progress, evidence coverage, net subscribers, estimated revenue, known cost, ROI, and comparisons by content pillar, format, and production provider. +At each real analytics window, YouTube Automation Agent stores subscriber gains and losses, watch hours, monetization evidence when the channel exposes it, and known production costs from durable scene records. **Analytics → Outcome & ROI Studio** shows target progress, evidence coverage, net subscribers, estimated revenue, known cost, ROI, and comparisons by content pillar, format, and production provider. -Missing evidence is explicit. A channel without monetization access shows revenue as unavailable rather than zero, and ROI stays unavailable until both revenue and complete cost evidence exist. When at least two comparable videos exist in each group, the learning engine can propose reallocating future content toward the pillar or format that best advances the configured outcome. That proposal remains pending until you approve it; Lumen never changes the strategy or budget silently. +Missing evidence is explicit. A channel without monetization access shows revenue as unavailable rather than zero, and ROI stays unavailable until both revenue and complete cost evidence exist. When at least two comparable videos exist in each group, the learning engine can propose reallocating future content toward the pillar or format that best advances the configured outcome. That proposal remains pending until you approve it; YouTube Automation Agent never changes the strategy or budget silently. ### Find the exact scene that lost viewers @@ -180,7 +180,7 @@ When three or more commenters ask for the same thing, the analysis mines an **au ## From idea to published video -| Stage | What Lumen does | What you control | +| Stage | What YouTube Automation Agent does | What you control | | --- | --- | --- | | Research | Finds topics and builds a content strategy | Niche, audience, blocked topics | | Script | Writes the hook, narrative, CTA, and metadata | Voice, format, length, brand direction | @@ -189,7 +189,7 @@ When three or more commenters ask for the same thing, the analysis mines an **au | Publish | Schedules and uploads approved content | Privacy, timing, final decision | | Learn | Captures 24-hour and 7-day evidence, measures the configured outcome and economics, then proposes the next move | Choose the KPI and approve or reject each learning before it guides planning | -Lumen distinguishes real MP4 output from simulated placeholders. Simulated output cannot enter the approval or publishing path. +YouTube Automation Agent distinguishes real MP4 output from simulated placeholders. Simulated output cannot enter the approval or publishing path. For release history, see [CHANGELOG.md](CHANGELOG.md). @@ -273,7 +273,7 @@ Local slideshow rendering remains the default, so upgrading does not start paid | Kuaishou | `kling-v3-omni` | Storyboards and character/voice consistency | 3–15 seconds | | Alibaba | Wan 2.7 task-specific models | Efficient generation, reference video, and continuation | 2–15 seconds | -Long-form productions use hybrid assembly: Lumen generates bounded provider clips for the hook and important sections, fills the remaining timeline locally, mixes the existing narration, and keeps the generated caption file alongside the production. As soon as a provider returns its task ID, Lumen persists it before polling so interrupted jobs can resume that known task instead of submitting it again. +Long-form productions use hybrid assembly: YouTube Automation Agent generates bounded provider clips for the hook and important sections, fills the remaining timeline locally, mixes the existing narration, and keeps the generated caption file alongside the production. As soon as a provider returns its task ID, YouTube Automation Agent persists it before polling so interrupted jobs can resume that known task instead of submitting it again. ## Configuration @@ -364,7 +364,7 @@ GENERATION_RETRY_BASE_MS=1000 The dashboard calculates setup, first-real-MP4, approval, publication, and repeat-generation milestones locally from SQLite and files on disk. A video counts only when a non-simulated `.mp4` with an MP4 container signature still exists. -Anonymous milestone reporting is disabled by default and has no built-in collector. It activates only when you explicitly set both telemetry variables. The allowlisted payload contains the milestone name and time, Lumen version, OS family, Node major version, and a random installation ID. It never includes credentials, channel data, prompts, topics, titles, filenames, or video contents. +Anonymous milestone reporting is disabled by default and has no built-in collector. It activates only when you explicitly set both telemetry variables. The allowlisted payload contains the milestone name and time, YouTube Automation Agent version, OS family, Node major version, and a random installation ID. It never includes credentials, channel data, prompts, topics, titles, filenames, or video contents. ## Automation Schedule @@ -585,7 +585,7 @@ If this was useful, check out: [@darkzOGx](https://github.com/darkzOGx), a solo builder shipping AI automation and developer tools. Find me on [X](https://x.com/darkzOGx) and [laderalabs.io](https://laderalabs.io). -If Lumen saves you time, a star helps it reach more developers. +If YouTube Automation Agent saves you time, a star helps it reach more developers. ## Contributing diff --git a/assets/demo/README.md b/assets/demo/README.md index 734ed988..0eb26048 100644 --- a/assets/demo/README.md +++ b/assets/demo/README.md @@ -1,6 +1,6 @@ # Demo capture specification -Capture a real Lumen run in approximately 30–45 seconds: +Capture a real YouTube Automation Agent run in approximately 30–45 seconds: 1. Enter: `Create a channel about forgotten American engineering projects`. 2. Start generation and show strategy, script, narration, visuals, video, thumbnail, and SEO stages completing. diff --git a/dashboard/app.js b/dashboard/app.js index 5bfba6d6..d1ba94c8 100644 --- a/dashboard/app.js +++ b/dashboard/app.js @@ -340,7 +340,7 @@ function renderChannelSnapshot(snapshot) { if (!snapshot.available) { $('#channel-snapshot-title').textContent = 'Channel snapshot'; container.innerHTML = empty(snapshot.reason || 'Channel statistics are unavailable.'); - note.textContent = 'Whole-channel totals from YouTube, including videos published outside Lumen.'; + note.textContent = 'Whole-channel totals from YouTube, including videos published outside YouTube Automation Agent.'; return; } // null means YouTube did not provide the value; it is shown as unavailable, never as 0. @@ -364,7 +364,7 @@ function renderChannelSnapshot(snapshot) { html += `
${escapeHTML(recent.reason || '28-day analytics are unavailable.')}${recent.activationUrl ? ` Enable YouTube Analytics API` : ''}
`; } container.innerHTML = html; - note.textContent = 'Whole-channel totals from YouTube, including videos published outside Lumen. Analytics data lags about two days.'; + note.textContent = 'Whole-channel totals from YouTube, including videos published outside YouTube Automation Agent. Analytics data lags about two days.'; } function formatOutcomeValue(value, kind = 'number', currency = 'USD') { @@ -451,7 +451,7 @@ function renderLearning(learning = {}) { ${item.status !== 'rejected' ? `` : ''} - `).join('') : empty('No recommendation yet. Lumen needs at least two real, sufficiently exposed measurements.'); + `).join('') : empty('No recommendation yet. YouTube Automation Agent needs at least two real, sufficiently exposed measurements.'); } function renderGrowthExperiments(summary = {}) { @@ -719,7 +719,7 @@ function renderActivation(activation = {}) { if (milestones.firstRealVideo?.achieved) { container.insertAdjacentHTML('beforeend', `
- Made something real with Lumen? + Made something real with YouTube Automation Agent? Share what you built
`); } @@ -832,7 +832,7 @@ function switchView(view) { $$('.view').forEach(item => item.classList.toggle('active', item.id === `${view}-view`)); const titles = { overview: ['OPERATOR OVERVIEW', 'Know what happens next.'], - operator: ['AUTONOMOUS OPERATOR', 'Give Lumen the strategy.'], + operator: ['AUTONOMOUS OPERATOR', 'Give YouTube Automation Agent the strategy.'], pipeline: ['CONTENT OPERATIONS', 'From idea to published.'], calendar: ['EDITORIAL PLANNING', 'Plan before you generate.'], analytics: ['PERFORMANCE', 'Turn results into the next move.'], @@ -1290,7 +1290,7 @@ document.addEventListener('click', async event => { const id = experiment.dataset.experimentId; const prompts = { approve: 'Approve this complete experiment plan? This does not change YouTube yet.', - start: 'Start this live test? Lumen will rotate only the approved arms and restore the control before asking you to adopt a winner.', + start: 'Start this live test? YouTube Automation Agent will rotate only the approved arms and restore the control before asking you to adopt a winner.', adopt: 'Adopt the evidence-backed winner on YouTube and approve its learning for future plans?', cancel: 'Cancel this experiment and restore the control title and thumbnail?' }; diff --git a/dashboard/enhance.js b/dashboard/enhance.js index a7fd064a..ef6e5d8e 100644 --- a/dashboard/enhance.js +++ b/dashboard/enhance.js @@ -1,5 +1,5 @@ /* ============================================================ - Lumen console enhancement layer — motion, command palette, + YouTube Automation Agent console enhancement layer — motion, command palette, instrumentation. Loads after app.js; touches nothing internal. Cross-file globals below are declared by app.js. ============================================================ */ @@ -31,7 +31,7 @@ /* ---------- 1. View choreography ---------- */ const VIEW_META = { overview: ['OPERATOR OVERVIEW', 'Know what happens next.', 'Overview'], - operator: ['AUTONOMOUS OPERATOR', 'Give Lumen the strategy.', 'Operator'], + operator: ['AUTONOMOUS OPERATOR', 'Give YouTube Automation Agent the strategy.', 'Operator'], pipeline: ['CONTENT OPERATIONS', 'From idea to published.', 'Pipeline'], calendar: ['EDITORIAL PLANNING', 'Plan before you generate.', 'Calendar'], analytics: ['PERFORMANCE', 'Turn results into the next move.', 'Analytics'], @@ -47,7 +47,7 @@ const previous = currentView; currentView = view; baseSwitchView(view); - document.title = `${VIEW_META[view][2]} · Lumen`; + document.title = `${VIEW_META[view][2]} · YouTube Automation Agent`; const section = $(`#${view}-view`); if (section) { // Directional slide: forward views enter from the right, back from the left. @@ -116,7 +116,7 @@ esc
-
↑↓ navigate↵ runLumen console
+
↑↓ navigate↵ runYouTube Automation Agent console
`; document.body.appendChild(palette); const listEl = palette.querySelector('.cmdk-list'); diff --git a/dashboard/index.html b/dashboard/index.html index 3a562963..8105d57c 100644 --- a/dashboard/index.html +++ b/dashboard/index.html @@ -86,7 +86,7 @@

Know what happens next.

-

Autonomous Channel Operator

Set the destination once. Lumen researches, plans, produces, and manages the channel workflow around it.

Not configured
+

Autonomous Channel Operator

Set the destination once. YouTube Automation Agent researches, plans, produces, and manages the channel workflow around it.

Not configured

CHANNEL MANDATE

What should this channel achieve?

@@ -115,7 +115,7 @@

Know what happens next.

-

EDITORIAL PLAN

What Lumen decided to make

+

EDITORIAL PLAN

What YouTube Automation Agent decided to make

@@ -140,10 +140,10 @@

Know what happens next.

YOUR CHANNEL ON YOUTUBE

Channel snapshot

-

Whole-channel totals from YouTube, including videos published outside Lumen.

+

Whole-channel totals from YouTube, including videos published outside YouTube Automation Agent.

-
Analyzed videos—analyzed by Lumen, last 7 days
+
Analyzed videos—analyzed by YouTube Automation Agent, last 7 days
Performance score—channel average
Recommended actionCollecting enough data to recommend a move.
diff --git a/dashboard/styles.css b/dashboard/styles.css index 5e4e45ea..e42739c8 100644 --- a/dashboard/styles.css +++ b/dashboard/styles.css @@ -1,5 +1,5 @@ /* ============================================================ - LUMEN — Operator Console + YOUTUBE AUTOMATION AGENT — Operator Console Design language: editorial control-room. Mono instrumentation, hairline structure, one saturated brand accent, layered depth. ============================================================ */ diff --git a/examples/README.md b/examples/README.md index cef08f16..44148880 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,4 +1,4 @@ -# Made with Lumen +# Made with YouTube Automation Agent This directory is reserved for verified output evidence. Do not add mock videos, simulated runs, or estimated results. @@ -16,7 +16,7 @@ For each example, provide: - Elapsed generation time: - Estimated API cost and calculation source: - Human editing time: -- Lumen version or commit: +- YouTube Automation Agent version or commit: - Final video URL: - Verification: non-simulated MP4 container signature confirmed ``` diff --git a/package.json b/package.json index 9c4b3f5d..247e5b13 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "youtube-automation-agent", "version": "2.11.0", - "description": "Lumen is an open-source AI agent that runs a YouTube channel end to end", + "description": "YouTube Automation Agent is an open-source AI agent that runs a YouTube channel end to end", "main": "index.js", "scripts": { "start": "node index.js", diff --git a/reports/growth/baseline-2026-08-18.md b/reports/growth/baseline-2026-08-18.md index 6334e0f6..06f28984 100644 --- a/reports/growth/baseline-2026-08-18.md +++ b/reports/growth/baseline-2026-08-18.md @@ -1,4 +1,4 @@ -# Lumen growth baseline — 2026-08-18 +# YouTube Automation Agent growth baseline — 2026-08-18 Captured at 2026-08-18T19:51:41.427Z. GitHub traffic and clone figures are rolling aggregates and are not cohort-aligned. diff --git a/reports/growth/fork-census-2026-08-18.md b/reports/growth/fork-census-2026-08-18.md index f6a6f7f6..914b3c3c 100644 --- a/reports/growth/fork-census-2026-08-18.md +++ b/reports/growth/fork-census-2026-08-18.md @@ -1,4 +1,4 @@ -# Lumen public fork census — 2026-08-18 +# YouTube Automation Agent public fork census — 2026-08-18 GitHub's repository summary reported 587 forks. The paginated REST census returned 597 unique public fork records and compared 40 high-signal candidates with upstream. diff --git a/reports/growth/prelaunch-readiness-2026-08-18.md b/reports/growth/prelaunch-readiness-2026-08-18.md index cca6b336..67d69986 100644 --- a/reports/growth/prelaunch-readiness-2026-08-18.md +++ b/reports/growth/prelaunch-readiness-2026-08-18.md @@ -1,4 +1,4 @@ -# Lumen pre-launch readiness — 2026-08-18 +# YouTube Automation Agent pre-launch readiness — 2026-08-18 ## Completed in repository diff --git a/scripts/growth/snapshot-github.js b/scripts/growth/snapshot-github.js index 0a1f54a9..4d1cb707 100644 --- a/scripts/growth/snapshot-github.js +++ b/scripts/growth/snapshot-github.js @@ -96,7 +96,7 @@ function selectForkCandidates(forks) { function markdownBaseline(snapshot) { const lines = [ - `# Lumen growth baseline — ${snapshot.snapshotDate}`, + `# YouTube Automation Agent growth baseline — ${snapshot.snapshotDate}`, '', `Captured at ${snapshot.capturedAt}. GitHub traffic and clone figures are rolling aggregates and are not cohort-aligned.`, '', @@ -141,7 +141,7 @@ function markdownBaseline(snapshot) { function markdownForks(census) { const lines = [ - `# Lumen public fork census — ${census.snapshotDate}`, + `# YouTube Automation Agent public fork census — ${census.snapshotDate}`, '', `GitHub's repository summary reported ${census.repositoryForkCount.toLocaleString()} forks. The paginated REST census returned ${census.totalForks.toLocaleString()} unique public fork records and compared ${census.comparedCandidates} high-signal candidates with upstream.`, '', diff --git a/walkthrough.js b/walkthrough.js index 26a69194..e312f991 100644 --- a/walkthrough.js +++ b/walkthrough.js @@ -379,7 +379,7 @@ class SetupWalkthrough { const { providerId } = await inquirer.prompt([{ type: 'list', name: 'providerId', - message: 'Which video provider should Lumen use?', + message: 'Which video provider should YouTube Automation Agent use?', choices: Object.entries(VIDEO_PROVIDER_GUIDE).map(([value, guide]) => ({ name: guide.label, value })) }]); const guide = VIDEO_PROVIDER_GUIDE[providerId];