Skip to content

feat(package): add Context Kit v1.0.1 - #150

Open
rezakhadjavi wants to merge 16 commits into
mainfrom
context-kit-package
Open

feat(package): add Context Kit v1.0.1#150
rezakhadjavi wants to merge 16 commits into
mainfrom
context-kit-package

Conversation

@rezakhadjavi

@rezakhadjavi rezakhadjavi commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Context Kit package — v0.8.0

Ships the Context Kit: the institutional-knowledge layer that turns the manual brand-context onboarding CS/sales does at kickoff into a self-serve, Runneth-drafted flow. Runneth drafts most of the context from Motion data; the customer confirms, corrects, and adds the few things only they know. Everything lands in the brain so every downstream answer is sharper.

What's in the package

  • Brain scaffolds (create-if-absent, never overwrite a customer-filled file): brand-context, KPIs/goal, spend-threshold, competitors, products, positioning, voice, voice-of-customer, legal-compliance, briefing-template, source-of-truth, guardrails.
  • Board app (apps/context-kit) — the openable status surface, grouped into three buckets: From Motion (confirm), Runneth drafted (review), Only you know (write-in).
  • Skill — builds/refreshes the kit, drafts from Motion creative data first, imports from Drive/Notion, researches customer language for VoC.
  • Behavior instructions — read-before-work rules + always-on self-improvement offer.

Board design (v0.8.0 redesign, this branch)

  • Contained header card: title + intro + progress + the three stages read as one unit.
  • Full-width disclosure rows (replaced the 2-col grid) for easier top-to-bottom skimming.
  • White inset box around each expanded detail panel.
  • runneth-ds token palette, darkened section headers, neutral link icon on the import nudge.
  • Personalized title/subhead via optional state.brandName (falls back to "Your Context Kit").

Architecture (please preserve on review)

  • Board is client-rendered: it fetches data/context-kit-state.json and each Bucket B data/*.md at runtime, so content/state updates need no rebuild (sync stages files but does not run app build).
  • State source of truth: /agent/brain/context-kit/context-kit-state.json, mirrored to the app's data/.

Manifest / validation

  • package.json, runneth-package.json, and package-index.json all at 0.8.0; indexRevision: context-kit-0.8.0.
  • node --test scripts/validate-runneth-package-index.mjs → 3/3 pass.

How to try it

  1. package install github:Motion-Creative/runneth-apps/packages/context-kit#context-kit-package
  2. app build context-kitapp list
  3. In chat: "build my Context Kit"

Notes for reviewers

  • Live visual reference (dummy Tatcha data, same board code): the vamsi-context-kit-ds preview app.
  • Staging test runs (Margaux / Eucalyptus) intentionally deferred by the owner for this cut.
  • Requires 2 approvers to merge.

@thedumsieffect
thedumsieffect marked this pull request as ready for review July 6, 2026 06:40
@thedumsieffect
thedumsieffect requested a review from a team July 6, 2026 06:40
Runneth (for Vamsi) added 10 commits July 6, 2026 02:41
…fetch board with click-to-expand, is:global styles, data/ scaffolds, richness + brand-context scoping (staging feedback)
…single /brain/context-kit folder, dataFile on all items, empty-state copy, Drive/Notion header nudge, help banner, app name fix
…earch (review-audit + brand-relevant-keywords + web + Levinger lived-context/trigger-moments), split brand voice from customer voice, add reviews-platform connect prompts + per-card enrich nudge
…ain (drafted vs inferred + sourceNote), board chrome redesign (brand-name title, compact nudge, numbered path + pips, butter color, unified View CTA), full markdown renderer, thoughtStarters + more enrich tips, bucket icons
… instruction detects thin files, offers to capture, logs gaps) + board 'Runneth wants to sharpen these' nudge surface
…rface, keep the always-on in-chat self-improvement offer (simpler, no stale state)
- Contained header card (title + intro + progress bar + stage rail as one unit)
- Full-width disclosure rows replacing 2-col grid (easier to skim)
- White inset box around each expanded detail panel
- Darkened section headers for legibility; neutral link icon on the import nudge
- Personalized title/subhead via optional state.brandName (graceful fallback)
- Preserves client-render + runtime state/markdown fetch (no rebuild needed)
The manual div + display-toggle panel broke layout in the app runtime
(open panel collapsed to a narrow overlapping column). Rebuild each row as
a real <details>/<summary> and lazy-load the markdown panel on the toggle
event. Preserves client-render + runtime fetch.
- Board: tabbed sections (Auto-filled / Drafted for you / Only you know / Your tools),
  clean underline tabs, white cards with status pills, cards open by default,
  meter reads 'N of X details confirmed / % complete', lede 'the way Runneth sees you'.
  Preserves levels rail, import nudge, and enrich tips.
- New Bucket D 'Your tools': integration source guides (generic scaffolds:
  ad-platform, asset-library, data-warehouse, reviews), excluded from the meter.
- Fold from Ioana's account-setup: two-section import contract + conflict rule
  for Bucket A (behavior.md, SKILL.md); validator rejects duplicate resource ids.
- Version 0.8.1 -> 0.9.0.
@rezakhadjavi

Copy link
Copy Markdown
Contributor Author

Update: tabbed board redesign + account-setup fold (v0.9.0)

Design (locked from a dummy-data preview reviewed in Slack):

  • Tabbed sections instead of one long scroll: Auto-filled / Drafted for you / Only you know / Your tools, clean underline tabs with per-tab counts.
  • White cards, state carried by status pills, cards open by default within a tab.
  • Progress meter reads "N of X details confirmed / % complete"; lede now "the way Runneth sees you".
  • Preserved the levels rail, the Drive/Notion import nudge, and per-card enrich tips.

New Your tools section (Bucket D): one guide per connected source (how the customer wants Runneth to USE it). Ships generic create-when-connected scaffolds (ad platform, asset library, data warehouse, reviews). Excluded from the completeness meter.

Folded in from the account-setup work (that package is not merging; this carries the useful parts):

  • Two-section import contract (Latest Import From Motion + Runneth Instructions) + conflict rule for Bucket A, in behavior.md and SKILL.md.
  • Validator now rejects duplicate resource ids.

Version 0.8.1 -> 0.9.0. Validator: 3/3 pass. App builds clean; state + nested integration data serve. Leaving the merge to the 2 approvers.

cursoragent and others added 2 commits July 20, 2026 10:41
Co-authored-by: vamsi <thedumsieffect@users.noreply.github.com>
Co-authored-by: vamsi <thedumsieffect@users.noreply.github.com>
Co-authored-by: vamsi <thedumsieffect@users.noreply.github.com>
@cursor cursor Bot changed the title feat(package): add context-kit feat(package): add Context Kit v1.0.0 Jul 20, 2026
cursoragent and others added 2 commits July 20, 2026 12:42
Co-authored-by: vamsi <thedumsieffect@users.noreply.github.com>
Co-authored-by: vamsi <thedumsieffect@users.noreply.github.com>
@cursor cursor Bot changed the title feat(package): add Context Kit v1.0.0 feat(package): add Context Kit v1.0.1 Jul 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants