ikenga-pkgs

PA dispatch — morning briefing, inbox/task triage, and send-queue dispatch for the personal-assistant surface. Reads `ikenga.db` via `host.dbQuery` (SELECT-only); triggers approved sends via `host.dbExec`. DISPATCH-ONLY: task and email CRUD belongs to the tasks and mail pkgs, not here. TRIGGER when the user asks for a morning briefing, inbox/task triage, or wants to dispatch queued sends. Runs as a Chi conversation in the dock. DO NOT TRIGGER for task or email CRUD (create/edit/delete). Route those to the tasks pkg or the mail pkg.

Turn a script (Fountain or plain text) into a populated com.ikenga.studio storyboard in one pass — segment it into shots (cells), tag the source script with each shot's id so the board and the script stay linked, and extract the recurring characters, locations, and props as reusable, seed-lockable anchors. Populates the board only; it generates nothing and spends nothing — the shots and anchor stubs are proposals for a human to review and approve before any fal render.

Read and search emails from local Thunderbird mail storage, and save reply drafts to the IMAP server. Use when agents need to access email data for financial workflows (payment receipts, billing notifications), editorial workflows (newsletter curation), or research workflows (industry intel), or to place a drafted reply into the user's Drafts folder for review. Triggers on email search, payment receipts, subscription notifications, newsletter extraction, or "save this as a draft / draft a reply in Thunderbird".

Finance dispatch — reconciliation sweep with match/pair/dispute decisions, A/R aging chase, and project setup for the finance domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only); approved decisions dispatch through the host write path. DISPATCH-ONLY: transaction CRUD and payment release belong to the finance app pkg (`com.ikenga.finance`), not here. TRIGGER when the user asks to reconcile transactions, review unmatched ledger rows, chase overdue invoices, or configure the finance skill for this project. DO NOT TRIGGER for transaction CRUD (create/edit/delete), payment release (approve-gate + host own it), or bank pull (external cron). DO NOT run KPI math — cash/burn/runway stays client-side in the pane (R-03 query-collapse). DO NOT send AR follow-ups directly — transport belongs to skill-outbound (R22).

Research dispatch — source-sweep with stale-refresh and dossier-commission proposals, and report-draft surface for the research domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only, `research_notes` + `research_sources`); approved proposals dispatch through the host write path. DISPATCH-ONLY: research CRUD belongs to the research app pkg (`com.ikenga.research`), not here. TRIGGER when the user asks for a research sweep, source freshness check, dossier commission proposals, or to draft a new research report or persona in chat. DO NOT TRIGGER for research CRUD (create/edit/delete/reassign from skill). Route those to the research app pkg. DO NOT run KPI math — that stays client-side in the pane (R-03). DO NOT run web-scraping or real-time source fetching — source re-scraping is dispatched through the host after operator approval.

Strategy dispatch — OKR review with countersign proposals, at-risk flagging, and objective-draft surface for the strategy domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only); approved review actions dispatch through the host write path. DISPATCH-ONLY: strategy CRUD belongs to the strategy app pkg (`com.ikenga.strategy`), not here. TRIGGER when the user asks for a strategy review, OKR sweep, cycle summary, at-risk objective flags, or to draft a new objective in chat. DO NOT TRIGGER for strategy CRUD (create/edit/delete/reassign from skill). Route those to the strategy app pkg. DO NOT run KPI math — that stays client-side in the pane (R-03). DO NOT query cross-domain tables directly — KR progress proxies from finance/sales stay client-side.

Mail dispatch — inbox triage, reply drafting, and setup for the mail domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only); produces draft decisions and reply artifacts for operator approval. DISPATCH-ONLY: email CRUD belongs to the mail pkg (`com.ikenga.mail`), not here. TRIGGER when the user asks to triage their inbox, draft a reply to a thread, or configure the mail skill. Runs as a Chi conversation in the dock. DO NOT TRIGGER for email CRUD (create/edit/delete messages, mark read/unread, snooze, tag). Route those to the mail pkg. Do NOT use this skill to send email — send routes through the approved-drafts queue owned by skill-pa `send`.

Outbound dispatch — campaign drafting, drip-sequence drafting, social queue management, and outbound-channel send dispatch. Reads `ikenga.db` via `host.dbQuery` (SELECT-only on read actions); commits delivery status transitions via `host.dbExec` on the approved `send` action only. DISPATCH-ONLY: outbound CRUD belongs to the outbound pkg (`com.ikenga.outbound`), not here. TRIGGER when the user asks to draft a newsletter/campaign, author a sequence step, schedule a social post, or dispatch the outbound send queue. Runs as a Chi conversation in the dock. DO NOT TRIGGER for outbound CRUD (create/edit/delete sequences, contacts, campaigns). Route those to the outbound pkg. Do NOT use this skill for mail-reply dispatch — that belongs to `skill-pa send` (non-outbound queue).

Content dispatch — pipeline-sweep with stage-advance proposals, stale-piece flagging, and piece-draft surface for the content domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only, pre-0047 base columns only); approved stage-advances dispatch through the host write path. DISPATCH-ONLY: content CRUD belongs to the content app pkg (`com.ikenga.content`), not here. TRIGGER when the user asks for a content pipeline review, editorial stage proposals, to flag stale pieces, or to draft a new content piece in chat. DO NOT TRIGGER for content CRUD (create/edit/delete/reassign from skill). Route those to the content app pkg. DO NOT run KPI math — that stays client-side in the pane (R-03). DO NOT produce, render, or schedule video — video production belongs to com.ikenga.studio (G-VIDEO-STACK, R23).

Cross-domain natural-language query — translate a question into parameterised SELECTs over ikenga.db and stream the answer. READ-ONLY: no INSERT, UPDATE, DELETE, or DROP is ever issued. One action: `query`. TRIGGER when the operator asks a question about data across any Ikenga domain (tasks, mail, sales, finance, content, research, strategy, agents, contacts). Runs as a Chi conversation in the dock, streaming the answer live. DO NOT TRIGGER for task/email/deal CRUD, briefing/digest generation, or any dispatch action. Those belong to the domain pkgs and skill-pa respectively.

Sales dispatch — pipeline-sweep with stage-advance proposals, stale-deal flagging, and deal-draft surface for the sales domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only, pre-0043 base columns only); approved stage-advances dispatch through the host write path. DISPATCH-ONLY: deal CRUD belongs to the sales app pkg (`com.ikenga.sales`), not here. TRIGGER when the user asks for a pipeline review, deal stage proposals, to flag stale deals, or to draft a new deal in chat. DO NOT TRIGGER for deal CRUD (create/edit/delete/reassign from skill). Route those to the sales app pkg. DO NOT run forecast math — that stays client-side in the pane (R-03).

Tasks dispatch — roster setup and completion-sweep for the tasks domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only); approved close-decisions dispatch through the host write path. DISPATCH-ONLY: task CRUD belongs to the tasks pkg (`com.ikenga.tasks`), not here. TRIGGER when the user asks to configure the project task roster, run a completion sweep, or close stale/done tasks in batch. DO NOT TRIGGER for task CRUD (create/edit/delete/reassign). Route those to the tasks app pkg.

skill-core — the generic identity hub for the Ikenga skill graph. Generates and maintains a project's identity (brand, founder voice, product, ICP) in `.atelier/skill-core/manifest.json` via the `setup` action, and is the single `depends_on` target every domain skill (tasks, mail, sales, outbound, finance, content, research, strategy) declares (the G-04 one-way star). TRIGGER when the user asks to set up / configure a project's identity for the Atelier skills, or runs `setup` for skill-core. Runs as a Chi conversation in the dock. DO NOT TRIGGER for any domain work (briefing, triage, sends, finance, content, etc.) — those belong to the domain skills, which depend on this one.

AI-generated vertical short — pattern-break hook → fast beats → cliffhanger close. 9:16 first.

Concept-first short — narration-led hook → problem → clarify → solution → CTA. Owns the hook.* and narration.* blocks.

Rhythm-cut montage — cold-open then rapid demo/proof beats over a music bed.

Audio-led cut — cells snap to a detected beat-grid. Run studio-beat-detect first to populate audio_analysis.

Story-driven piece. Fountain-aware: reads <project>/script.fountain natively into the Script shape.

Product walkthrough — hook → problem → solution → demo → features → proof → CTA. Owns the beat.* blocks.

Step-by-step how-to — question hook → clarify → demo → feature-list → CTA. Longest default runtime.

Ships the universal Studio blocks shared across every archetype — transitions, SFX, music presets, CTAs, anchor packs, and sketch scenes — under blocks/, discovered by the catalog loader alongside archetype-owned blocks.

Analyse a music-video project's audio track with python3 + librosa to populate Project.audio_analysis — bpm, downbeats, beats, and onsets in milliseconds — so the timeline can snap cell durations to the beat grid.

Preflight the Studio toolchain — checks ffmpeg, a Chromium for HyperFrames, and bun (required), plus python3 + librosa (optional, music-video only). Warns rather than fails when an optional dependency is missing.

Interview the user to design a custom archetype — chain existing blocks into an ordered sequence with per-instance bindings — then save it as a custom archetype.json via archetype.save_custom.

Scaffold a new Studio block — a schema-valid block.json plus its template (index.html for HyperFrames, .excalidraw for sketch) — and register it via block.create_custom.

Bootstrap a new com.ikenga.studio project — interview for archetype, create the project folder, and instantiate the chosen archetype's block chain into a fresh storyboard.json.

Turn a single prompt straight into a rendered MP4 with no persistent project folder — pick an archetype implicitly, instantiate in a temp workspace, render hi-fi, and hand back the file path.

Agent-driven build loop — kick off cell renders and return immediately while the canvas auto-pans to the active cell; poll render.list for completion instead of blocking.