Documentation

BeaconCLIcreatorruntimedocs.

BeaconCLI coordinates autonomous creator workflows through typed stages, local deterministic adapters, artifacts, provider action records, analytics scoring, and Gitlawb-style memory.

RepositoryWhitepaper

Pipeline run

One execution of a staged creator workflow, from objective to analytics feedback.

Creator agent

A specialist class that owns a stage and returns structured outputs through a small runtime contract.

Provider adapter

A social or media provider boundary for publishing, scheduling, analytics, comments, rendering, image, or voice operations.

Artifact

A durable local JSON record for scripts, media metadata, render outputs, provider actions, logs, and optimization notes.

Memory commit

A Gitlawb-style versioned memory record with author agent, parent commit, changed files, and metadata.

Commands

Localworkflowoperations

npm install

Install the local TypeScript runtime dependencies.

npm run waypoint -- run gaming

Run the gaming creator workflow sample.

npm run waypoint -- run lifestyle

Run the lifestyle creator workflow sample.

npm run waypoint -- inspect <runId>

Inspect a persisted pipeline run and generated artifacts.

npm run waypoint -- memory

List Gitlawb-style local memory commits.

npm run waypoint -- clean

Remove local JSON run, artifact, memory, and provider-action records.

npm run lint

Check the runtime source.

npm test

Run Vitest coverage for runtime, memory, providers, and analytics scoring.

Pipeline stages

Each stage includes an ID, type, name, assigned agent, status, schema names, and generated artifacts so creator workflow execution can be inspected after the run.

01trend_discovery
02strategy_planning
03scriptwriting
04media_generation
05video_editing
06remotion_render
07platform_publish
08community_engagement
09analytics_review
10optimization_loop

Local JSON persistence

Runs, memory commits, artifacts, and provider actions live under local data directories.

Typed contracts

Agents expose id, name, role, capabilities, and a run(context, input) method.

Vitest coverage

Runtime completion, memory commits, provider adapters, and analytics recommendations are tested.