You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add a new Conversation Arc docs page with interactive demos (conversation arc store + freshness scrubber), wire the route into the docs app and nav, and include the new blog entry "talk-track-intelligence". Update docs metadata and entries to surface the new post. Standardize provenance/lifecycle field names to camelCase (e.g. createdAt, stableId, ttlHint, baseComponent, variantKey, proposalId) across docs and examples and update related tests. Tweak prerender route titles and a minified-shell test fixture; adjust prev/next links between feature pages. Overall: docs + demo additions, minor API/docs text changes, and test updates to match the new naming.
### Annotation provenance + lifecycle (`semiotic/ai`, types also re-exported from `semiotic`)
345
345
Type surface for "where did this annotation come from?" and "is it stale?" Optional blocks attached to any annotation — existing arrays keep working unchanged.
346
-
-**`provenance`**: `{ author?, source?, confidence?, created_at?, stable_id? }`. `source` is an open string union (`"user" | "ai" | "agent" | "import" | "computed" | "system" | (string & {})`).
347
-
-**`lifecycle`**: `{ freshness?, ttl_hint?, anchor? }`. `freshness` is `"fresh" | "aging" | "stale" | "expired"`. `anchor` is `"fixed" | "latest" | "sticky" | "semantic"`. `ttl_hint` accepts an ISO 8601 duration string (`"P30D"`) or milliseconds.
346
+
-**`provenance`**: `{ author?, source?, confidence?, createdAt?, stableId? }`. `source` is an open string union (`"user" | "ai" | "agent" | "import" | "computed" | "system" | (string & {})`).
347
+
-**`lifecycle`**: `{ freshness?, ttlHint?, anchor? }`. `freshness` is `"fresh" | "aging" | "stale" | "expired"`. `anchor` is `"fixed" | "latest" | "sticky" | "semantic"`. `ttlHint` accepts an ISO 8601 duration string (`"P30D"`) or milliseconds.
348
348
-**`withProvenance(annotation, { provenance?, lifecycle? })`** → returns a new annotation with the blocks attached. Pure, SSR-safe.
349
349
-**`Annotated<T>`** type alias: `T & { provenance?, lifecycle? }`. Use for explicit typing.
350
350
- Type surface only at this stage. Freshness computation, default visual treatment, and stable-id anchor resolution land later.
@@ -355,16 +355,16 @@ import { withProvenance } from "semiotic/ai"
Interface for proposing and scoring chart variants beyond the hand-curated `capability.variants`. Heuristic and model-based proposers plug in through `registerVariantDiscovery`. M1 ships the type surface + stub implementations; behavior arrives in subsequent milestones.
-**`evaluateVariantProposal(proposal, profile, audience?)`** → `VariantScore`. M1 stub returns a neutral baseline with a reason pointing back at the design doc.
370
370
-**`registerVariantDiscovery(fn)`** → registers an external proposer, returns an unregister callback. Pair with `getRegisteredVariantDiscovery()` / `clearVariantDiscovery()` for inspection and teardown.
"3.6.0 turns Semiotic's observation hooks, native annotations, and streaming runtime into an explicit AI-facing surface. Charts declare what they're for; datasets get profiled and ranked; audiences get calibrated; conversations anchor back to the chart instead of stopping at a chat bubble. Three case-study posts published alongside the release walk through what the new shape makes possible.",
32
32
},
33
+
{
34
+
slug: "talk-track-intelligence",
35
+
title: "The arc, the annotation, and the variant",
36
+
subtitle:
37
+
"Three composable AI surfaces shipping together in 3.5.x: conversation-arc telemetry, annotation provenance + lifecycle, and a variant discovery plug point. Two are runnable inline.",
38
+
author: "Elijah Meeks",
39
+
date: "2026-05-27",
40
+
tags: ["case-study","ai","roadmap"],
41
+
excerpt:
42
+
"AI-assisted chart authoring is a session, not a single call. Semiotic 3.5.x lands the spine for treating that session as a first-class thing — an event vocabulary for the arc itself, provenance + lifecycle on every annotation, and an extension surface for variant proposers. Interactive demos for the first two.",
0 commit comments