@agent-native/core 0.130.2 → 0.131.3

package/corpus/templates/content/docs/product/features/content.feature.move-without-starting-over.md

@@ -0,0 +1,38 @@
+---
+record_type: "feature"
+id: "content.feature.move-without-starting-over"
+number: 30
+name: "Move without starting over"
+chapter: "content.chapter.publishing-portability"
+order: 30
+roadmap_status: "partially_implemented"
+summary: "Import or migrate a foreign corpus with resumable progress, provenance, repair, and a readable conversion report."
+example_workflow: "A team imports a large Notion workspace, closes the browser halfway through, resumes without duplicate Pages, and reviews a conversion report showing transformed Properties and unresolved assets."
+works_today: "Markdown and MDX import, Notion workflows, Builder pulls, local-folder synchronization, provenance, and provider identities already support several bounded migration paths."
+remains: "Large migrations need durable server-side orchestration, checkpoints, idempotent deduplication, broader schema fidelity, conversion reports, asset repair, resumability, and explicit partial-failure recovery."
+required_capabilities:
+  [
+    "content.job.durable",
+    "content.source.adapters",
+    "content.portability.roundtrip",
+  ]
+enhancing_capabilities: ["content.source.catalog", "content.event.committed"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 30: Move without starting over
+
+Import or migrate a foreign corpus with resumable progress, provenance, repair, and a readable conversion report.
+
+## Product contract
+
+- **Canonical import model:** Maps Pages, Databases, Properties, Blocks, relationships, files, and metadata into stable Content objects.
+- **Provider-specific adapters:** Interpret Notion, local vaults, Builder, Drive, and later formats without making any provider's dialect the core model.
+- **Checkpoint and resume:** Continues large migrations after interruption without duplicating already accepted records.
+- **Identity and deduplication:** Preserves stable source IDs and makes repeated imports repair or update the intended objects.
+- **Conversion report:** Explains unsupported or transformed semantics instead of quietly dropping them.
+- **Repair workflows:** Lets people and agents inspect unresolved mappings, missing assets, conflicts, and partial failures.
+- **Provenance:** Keeps enough source context to compare, refresh, or understand the imported material later.

package/corpus/templates/content/docs/product/features/content.feature.plan-work-across-time.md

@@ -0,0 +1,39 @@
+---
+record_type: "feature"
+id: "content.feature.plan-work-across-time"
+number: 19
+name: "Plan work across time"
+chapter: "content.chapter.working-systems"
+order: 19
+roadmap_status: "planned"
+summary: "Edit dates and dependencies through Timeline and Gantt-style planning while preserving the same typed records underneath."
+example_workflow: "A project manager opens a Timeline, drags a blocked launch task into the following week, sees the dependency conflict, accepts a proposed schedule repair, and preserves the updated dates and Relationships everywhere else."
+works_today: "A Timeline renderer, typed date Properties, drag editing, relations, grouping, and shared View configuration already exist as partially proven pieces."
+remains: "Timeline needs full renderer conformance and polish, while dependency metadata, schedule constraints, milestones, repair proposals, critical path, and Gantt-style interaction remain planned layers."
+required_capabilities:
+  [
+    "content.view.timeline",
+    "content.time.types",
+    "content.relationship.edge",
+    "content.schedule.constraints",
+  ]
+enhancing_capabilities:
+  ["content.system.dependencies", "content.view.grouping-aggregation"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 19: Plan work across time
+
+Edit dates and dependencies through Timeline and Gantt-style planning while preserving the same typed records underneath.
+
+## Product contract
+
+- **Timeline:** Places records across typed dates, Instants, ranges, and durations.
+- **Direct manipulation:** Moves or resizes permitted work through ordinary typed Actions.
+- **Dependency connectors:** Renders the same Relationships used by Queries and project workflows.
+- **Schedule constraints:** Detects invalid ordering and either refuses, explains, or proposes a repair according to policy.
+- **Gantt mode:** Combines Timeline, dependencies, milestones, grouping, and schedule behavior without becoming another View family.
+- **Critical path:** Remains a later planning layer after dependency and constraint semantics are dependable.

package/corpus/templates/content/docs/product/features/content.feature.publish-with-confidence.md

@@ -0,0 +1,43 @@
+---
+record_type: "feature"
+id: "content.feature.publish-with-confidence"
+number: 28
+name: "Publish with confidence"
+chapter: "content.chapter.publishing-portability"
+order: 28
+roadmap_status: "partially_implemented"
+summary: "Publish one chosen revision faithfully while private collaborative work continues behind it."
+example_workflow: "An editor publishes the current approved article revision, continues working privately on a new Version, previews exactly what public readers can see, and updates the stable URL only when the replacement is ready."
+works_today: "Content already supports sharing, public Pages, stable links, several exports, access checks, and server-rendered public surfaces."
+remains: "Publication must bind to an exact revision or named Version, preview the real audience closure, render every Block faithfully, isolate private collaboration, preserve lifecycle history, and become polished enough for dependable CMS use."
+required_capabilities:
+  [
+    "content.publish.public",
+    "content.publish.reading",
+    "content.access.visibility-closure",
+  ]
+enhancing_capabilities:
+  [
+    "content.version.branching",
+    "content.portability.pdf-export",
+    "content.property.guarded-change",
+  ]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 28: Publish with confidence
+
+Publish one chosen revision faithfully while private collaborative work continues behind it.
+
+## Product contract
+
+- **Publication object:** Binds one public destination to a Page, selected Version, and exact revision.
+- **Page-first publishing:** Keeps Publish, Update publication, and Unpublish inside the familiar Page sharing surface.
+- **Stable public URL:** Serves the last explicitly published truth rather than following every private edit automatically.
+- **Rich Block fidelity:** Renders every accepted Block family or a deliberate safe fallback through the shared semantic renderer.
+- **Audience preview:** Shows what the public reader can actually access before publication.
+- **Private-work separation:** Prevents Comments, Discussion, unpublished Versions, inaccessible assets, and internal Properties from leaking.
+- **Lifecycle history:** Records who published, updated, or withdrew which revision and preserves the public artifact's provenance.

package/corpus/templates/content/docs/product/features/content.feature.put-your-organizations-know-how-to-work.md

@@ -0,0 +1,38 @@
+---
+record_type: "feature"
+id: "content.feature.put-your-organizations-know-how-to-work"
+number: 15
+name: "Put your organization's know-how to work"
+chapter: "content.chapter.working-systems"
+order: 15
+roadmap_status: "planned"
+summary: "Govern reusable Skills so the agent offers the right instructions for the current person and object."
+example_workflow: "A writer selects a paragraph and opens Ask Agent; Content prioritizes the organization's approved voice-and-style Skill, explains that it will propose a replacement, and records the resulting edits when invoked."
+works_today: "The Agent Native framework already loads governed developer Skills, and Content provides selection context and the shared Agent chat for carrying out authorized work."
+remains: "Content needs a user-manageable Skills catalog, scope and compatibility rules, contextual discovery, specific-over-general ranking, clear mutation previews, and shared invocation for people and agents."
+required_capabilities:
+  [
+    "content.expression.catalog",
+    "content.agent.skill-catalog",
+    "content.agent.expression-authoring",
+  ]
+enhancing_capabilities:
+  ["content.template.governance", "content.command.fabric"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 15: Put your organization's know-how to work
+
+Govern reusable Skills so the agent offers the right instructions for the current person and object.
+
+## Product contract
+
+- **Skills catalog:** Stores governed instructions with personal, workspace, organization, or public-core scope.
+- **Compatibility:** Surfaces only Skills that apply to the current selection, Block, Page, Database, Property, or View.
+- **Scope precedence:** Ranks the most relevant allowed instruction without flooding the interface with the entire catalog.
+- **Declared effects:** Explains whether invocation proposes edits, replaces content, adds a Comment, or acts elsewhere.
+- **Shared invocation:** Lets people and agents use the same Skill through the ordinary Agent chat and Action fabric.
+- **Receipts:** Records what instruction ran, against which context, with which resulting actions.

package/corpus/templates/content/docs/product/features/content.feature.read-and-annotate-anything.md

@@ -0,0 +1,38 @@
+---
+record_type: "feature"
+id: "content.feature.read-and-annotate-anything"
+number: 25
+name: "Read and annotate anything"
+chapter: "content.chapter.capture-research"
+order: 25
+roadmap_status: "planned"
+summary: "Read comfortably, mark exact material, preserve revision context, and find those Annotations again."
+example_workflow: "A researcher opens a PDF, adjusts the reading layout, highlights an exact passage, adds a durable Annotation, and later finds it from the Annotations rail even after the source receives a new revision."
+works_today: "Content already renders rich documents and media Blocks, supports anchored Comments, stores source representations, and has ordinary reading and export foundations."
+remains: "The dedicated Reader experience, durable Annotation object and rail, precise selectors across media, revision-aware anchoring, carry-forward, reading preferences, progress, dictation, and read-aloud are still planned."
+required_capabilities:
+  [
+    "content.reader.surface",
+    "content.research.annotation",
+    "content.author.media",
+  ]
+enhancing_capabilities: ["content.version.branching", "content.source.adapters"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 25: Read and annotate anything
+
+Read comfortably, mark exact material, preserve revision context, and find those Annotations again.
+
+## Product contract
+
+- **Reader surface:** Provides personal typography, width, pagination, theme, progress, and distraction-free modes.
+- **Document and media representations:** Supports text, transcripts, PDFs, EPUBs, audio, video, and source-aware fallbacks over stable asset handles.
+- **Annotations:** Store durable highlights, notes, tags, reactions, or structured extractions independently from resolvable Comments.
+- **Precise selectors:** Anchor to text ranges, pages, regions, timestamps, transcript ranges, and the source revision being viewed.
+- **Annotations rail:** Reveals highlights only when opened and supports search, filtering, grouping, re-anchoring, and orphan repair.
+- **Carry-forward:** Moves a filtered set of relevant Annotations to another named Version without pretending every old anchor still exists.
+- **Speech:** Adds dictation and read-aloud through shared Agent Native capabilities rather than a Reader-only AI system.

package/corpus/templates/content/docs/product/features/content.feature.review-changes-in-place.md

@@ -0,0 +1,39 @@
+---
+record_type: "feature"
+id: "content.feature.review-changes-in-place"
+number: 7
+name: "Review changes in place"
+chapter: "content.chapter.consensus"
+order: 7
+roadmap_status: "partially_implemented"
+summary: "Accept or reject proposed human and agent changes in the ordinary Content interface."
+example_workflow: "An agent revises a live article and its metadata; the editor reviews the rendered Page, accepts the stronger passages, rejects an incorrect Property change, and leaves the remaining suggestions pending for another pass."
+works_today: "Source change sets, Builder review machinery, audit records, and document snapshots prove several parts of the review loop and provide useful donor implementations."
+remains: "Content needs one generic typed diff and suggestion system that reviews bodies, Properties, Blocks, and filtered record sets directly in their ordinary renderers."
+required_capabilities:
+  [
+    "content.diff.in-place",
+    "content.diff.filtered-review",
+    "content.revision.suggestions",
+    "content.event.committed",
+    "content.history.queryable",
+  ]
+enhancing_capabilities: ["content.diff.ai-assist", "content.review.code"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 7: Review changes in place
+
+Accept or reject proposed human and agent changes in the ordinary Content interface.
+
+## Product contract
+
+- **Suggestions:** Preserve a pending change set without mutating the canonical Page immediately.
+- **Typed diffs:** Compare body content, Properties, Blocks, and structured values through their normal renderers.
+- **Filtered review:** Review only the affected or relevant subset without losing dependent changes outside the current filter.
+- **Selective acceptance:** Accept all, reject all, or choose individual compatible changes without seven ceremonial confirmation screens.
+- **Stale changes:** Detect when the underlying material has moved and offer an honest rebase, refresh, or conflict state.
+- **Agent-authored work:** Group an agent run into one inspectable Revision whose changes remain attributable and recoverable.

package/corpus/templates/content/docs/product/features/content.feature.run-projects-your-way.md

@@ -0,0 +1,44 @@
+---
+record_type: "feature"
+id: "content.feature.run-projects-your-way"
+number: 18
+name: "Run projects your way"
+chapter: "content.chapter.working-systems"
+order: 18
+roadmap_status: "partially_implemented"
+summary: "Use an editable Task and Project system built from ordinary Content rather than a second hidden engine."
+example_workflow: "A product team installs the blessed project Template, captures tasks from the keyboard, assigns owners, links subtasks and dependencies, and uses My Tasks while every task remains an ordinary editable Page."
+works_today: "Pages, Databases, status and person Properties, relations, Board and Calendar Views, Templates, Comments, and agent Actions already let teams assemble useful project systems."
+remains: "The blessed Template needs fast capture, polished defaults, task and subtask Views, My Tasks, activity, dependencies, permissions, and end-to-end Builder dogfooding without introducing a separate task engine."
+required_capabilities:
+  [
+    "content.system.task-project",
+    "content.system.my-tasks",
+    "content.system.dependencies",
+    "content.system.project-status",
+  ]
+enhancing_capabilities:
+  [
+    "content.view.fast-capture",
+    "content.relationship.edge",
+    "content.notification.source",
+  ]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 18: Run projects your way
+
+Use an editable Task and Project system built from ordinary Content rather than a second hidden engine.
+
+## Product contract
+
+- **Blessed Template:** Provides a strong starting system that remains inspectable and editable like any other Content setup.
+- **Fast capture:** Creates work quickly with unambiguous View-derived defaults and useful keyboard navigation.
+- **Assignments:** Use ordinary typed Person and Team Properties with access-safe attention and notifications.
+- **Subtasks and dependencies:** Store hierarchy and blocking relationships through typed Relations with cycle protection.
+- **My Tasks:** Queries assigned work across authorized memberships without inventing a private task datastore.
+- **Project status:** Combines explicit owner judgment with useful rollups rather than pretending a formula can manage the project.
+- **Ordinary Pages:** Lets every Task retain rich content, Properties, Discussion, Versions, and the ability to join other Databases.

package/corpus/templates/content/docs/product/features/content.feature.see-your-information-your-way.md

@@ -0,0 +1,44 @@
+---
+record_type: "feature"
+id: "content.feature.see-your-information-your-way"
+number: 5
+name: "See your information your way"
+chapter: "content.chapter.durable-home"
+order: 5
+roadmap_status: "in_validation"
+summary: "Move among compatible Database and Query Views without changing the records underneath."
+example_workflow: "A marketing team edits its editorial Database as a Table, plans work on a Board and Calendar, then gives executives a compact List of the same canonical articles."
+works_today: "Table, List, Board, Gallery, Calendar, Timeline, and Form renderers already exist, along with shared filters, sorts, grouping, calculations, and visible-field controls."
+remains: "Every renderer needs the same proven permissions, Actions, agent context, accessibility, persistence, performance, keyboard behavior, and recovery. Incomplete Views should remain gated until they pass that contract."
+required_capabilities:
+  [
+    "content.renderer.typed",
+    "content.view.query",
+    "content.view.renderer-conformance",
+    "content.view.scale",
+  ]
+enhancing_capabilities:
+  [
+    "content.view.fast-capture",
+    "content.view.grouping-aggregation",
+    "content.view.timeline",
+  ]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 5: See your information your way
+
+Move among compatible Database and Query Views without changing the records underneath.
+
+## Product contract
+
+- **Table and List:** Support fast scanning, keyboard navigation, inline editing, and flexible visible fields.
+- **Board and Gallery:** Arrange records by workflow state or visual identity while preserving canonical records.
+- **Calendar and Timeline:** Place records across dates and ranges through the same typed time Properties.
+- **Form:** Collect new records through a saved presentation of the Database's schema and validation.
+- **View controls:** Filter, sort, group, format, and conditionally style each presentation.
+- **Density:** Adjust compact, cozy, or comfortable spacing and secondary information without creating another View type.
+- **Renderer conformance:** Gives every View the same permissions, Actions, agent context, accessibility, persistence, and recovery contract.

package/corpus/templates/content/docs/product/features/content.feature.share-how-your-organization-works.md

@@ -0,0 +1,38 @@
+---
+record_type: "feature"
+id: "content.feature.share-how-your-organization-works"
+number: 14
+name: "Share how your organization works"
+chapter: "content.chapter.working-systems"
+order: 14
+roadmap_status: "partially_implemented"
+summary: "Govern reusable Templates, Properties, Expressions, and Custom Blocks without taking ownership away from adopters."
+example_workflow: "An administrator publishes an approved editorial Template with governed Properties and Expressions; any team can inspect and adopt it, customize the local system, or detach without losing its existing records."
+works_today: "Content already has Templates and several reusable configuration surfaces, while source Properties and local components demonstrate governed and source-backed reuse patterns."
+remains: "Templates, Custom Properties, Expressions, and Custom Blocks need one understandable catalog model with ownership scope, inspection, adoption, local aliasing, provenance, and faithful detachment."
+required_capabilities:
+  [
+    "content.template.graph",
+    "content.template.governance",
+    "content.template.item-body",
+  ]
+enhancing_capabilities:
+  ["content.property.catalog", "content.organization.teams"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 14: Share how your organization works
+
+Govern reusable Templates, Properties, Expressions, and Custom Blocks without taking ownership away from adopters.
+
+## Product contract
+
+- **Templates:** Package Pages, Databases, Views, Properties, Rules, and content into reusable starting systems.
+- **Custom Properties:** Offer approved reusable field definitions without making every ordinary local column secretly global.
+- **Expressions:** Store reusable typed logic with personal, workspace, or organization scope.
+- **Catalog discovery:** Uses consistent names, descriptions, aliases, ownership, compatibility, and previews.
+- **Adoption:** Lets someone inspect a governed building block before binding it into their local system.
+- **Detachment:** Preserves the current data and behavior as a faithful local copy when someone leaves the shared lineage.

package/corpus/templates/content/docs/product/features/content.feature.sketch-connections-keep-whats-true.md

@@ -0,0 +1,39 @@
+---
+record_type: "feature"
+id: "content.feature.sketch-connections-keep-whats-true"
+number: 27
+name: "Sketch connections, keep what's true"
+chapter: "content.chapter.capture-research"
+order: 27
+roadmap_status: "planned"
+summary: "Arrange canonical Content on a Canvas, sketch possible connections, and promote only meaningful typed Relationships."
+example_workflow: "A researcher arranges Sources, claims, and Annotations on a Canvas, draws tentative lines while thinking, and promotes only the strongest line into a typed Supports relationship that Queries and agents can use."
+works_today: "Canonical Pages, Blocks, references, relation Properties, Queries, and embeddable Views provide the objects and edges a spatial surface can eventually arrange."
+remains: "Canvas, view-local connectors, promotion into typed Relationships, semantic Graph editing, mind maps, force-directed layouts, and graph traversal remain planned capabilities."
+required_capabilities:
+  [
+    "content.view.canvas",
+    "content.view.graph",
+    "content.knowledge.graph",
+    "content.relationship.edge",
+  ]
+enhancing_capabilities: ["content.query.object", "content.research.annotation"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 27: Sketch connections, keep what's true
+
+Arrange canonical Content on a Canvas, sketch possible connections, and promote only meaningful typed Relationships.
+
+## Product contract
+
+- **Canvas:** Places Pages, Blocks, Sources, Annotations, media, Views, and Query results in an intentional spatial arrangement.
+- **Reusable objects:** Keeps every card or node connected to its canonical Content identity instead of becoming a canvas-only copy.
+- **Visual connectors:** Supports brainstorming lines that remain local to the Canvas until their meaning is known.
+- **Promote to Relationship:** Turns a chosen connector into a named typed edge that becomes queryable everywhere.
+- **Semantic Graph mode:** Creates an already-selected Relationship type directly when the person is deliberately editing the graph.
+- **Mind maps and layouts:** Offer hierarchical, grouped, and force-directed arrangements over the same objects and edges.
+- **Graph exploration:** Later adds traversal, paths, cycles, ranking, and pattern queries after the relationship substrate is proven.

package/corpus/templates/content/docs/product/features/content.feature.take-the-whole-vault-with-you.md

@@ -0,0 +1,39 @@
+---
+record_type: "feature"
+id: "content.feature.take-the-whole-vault-with-you"
+number: 29
+name: "Take the whole vault with you"
+chapter: "content.chapter.publishing-portability"
+order: 29
+roadmap_status: "partially_implemented"
+summary: "Export the complete authorized vault into open, understandable formats and a lossless Content archive."
+example_workflow: "An organization exports every object the acting administrator can access into an open Markdown, CSV, assets, and manifest vault plus a lossless Content archive, then verifies the package without Content."
+works_today: "Content exports Page bodies as Markdown, HTML, and PDF-shaped output and can export editable Markdown or MDX source, with local-file workflows already proving part of the portability model."
+remains: "Whole-vault export needs CSV, assets, an open manifest, a lossless Content archive, Notion-compatible packaging, authorized dependency closure, resumable jobs, verification, and Desktop backup."
+required_capabilities:
+  [
+    "content.portability.vault-export",
+    "content.portability.roundtrip",
+    "content.job.durable",
+  ]
+enhancing_capabilities:
+  ["content.portability.pdf-export", "content.source.local-bridge"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 29: Take the whole vault with you
+
+Export the complete authorized vault into open, understandable formats and a lossless Content archive.
+
+## Product contract
+
+- **Open vault:** Uses Markdown or MDX, CSV, ordinary asset folders, and a small manifest for stable IDs and richer semantics.
+- **Lossless Content archive:** Preserves Versions, Discussion, Comments, Annotations, Rules, provenance, and other Content-specific meaning.
+- **Target packages:** Produces destination-aware exports, beginning with a Notion-compatible package and conversion report.
+- **Authorized closure:** Materializes exactly what the exporter can currently see without leaking inaccessible dependencies.
+- **Assets and Sources:** Includes authorized files or stable handles and reports anything that could not be resolved.
+- **Durable transfer job:** Supports progress, interruption, retry, and resume without duplicating work.
+- **Local backup:** Lets Desktop maintain a user-chosen portable vault separately from its fast disposable cache.

package/corpus/templates/content/docs/product/features/content.feature.trust-your-connected-sources.md

@@ -0,0 +1,40 @@
+---
+record_type: "feature"
+id: "content.feature.trust-your-connected-sources"
+number: 10
+name: "Trust your connected Sources"
+chapter: "content.chapter.connected-sources"
+order: 10
+roadmap_status: "partially_implemented"
+summary: "Keep supported edits synchronized according to one plain-language policy without silently losing provider-specific content."
+example_workflow: "An editor updates a Builder article from Content; the supported changes synchronize, an unknown Builder component survives untouched, and changing Draft to Published remains a separate guarded action."
+works_today: "Builder change sets, guarded writes, raw sidecars, local-folder synchronization, and source metadata already preserve several difficult round-trip and conflict boundaries."
+remains: "Every adapter needs certification against one plain-language sync policy, seamless automatic synchronization where safe, faithful unknown-content preservation, explicit lifecycle changes, and dependable receipts."
+required_capabilities:
+  [
+    "content.source.sync-policy",
+    "content.portability.roundtrip",
+    "content.source.adapters",
+    "content.source.builder-codec",
+  ]
+enhancing_capabilities:
+  ["content.property.guarded-change", "content.event.committed"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 10: Trust your connected Sources
+
+Keep supported edits synchronized according to one plain-language policy without silently losing provider-specific content.
+
+## Product contract
+
+- **View only:** Pulls authorized changes into Content and never writes back.
+- **Keep in sync:** Moves compatible changes in both directions automatically and interrupts only for a genuine conflict.
+- **Review before write-back:** Bundles Content-originated changes into one reviewable set when the workflow requires care.
+- **Faithful round-tripping:** Preserves unknown provider-owned structures even when Content cannot render or edit them.
+- **Conflict handling:** Uses stable identity and base revisions to prevent silent last-writer-wins data loss.
+- **Provider lifecycle:** Treats states such as Draft and Published as explicit guarded changes rather than side effects of ordinary editing.
+- **Receipts and retries:** Confirms what the provider actually accepted and retries without duplicating effects.

package/corpus/templates/content/docs/product/features/content.feature.understand-what-your-data-says.md

@@ -0,0 +1,39 @@
+---
+record_type: "feature"
+id: "content.feature.understand-what-your-data-says"
+number: 22
+name: "Understand what your data says"
+chapter: "content.chapter.working-systems"
+order: 22
+roadmap_status: "partially_implemented"
+summary: "Use Charts, Pivots, grouping, measures, and drill-down without creating a separate analytics datastore."
+example_workflow: "A marketing analyst groups campaigns by channel, compares spend and conversions in a Chart and Pivot, then drills into one surprising aggregate to inspect the canonical campaigns behind it."
+works_today: "Database calculations, grouping, rollup foundations, and chart tooling elsewhere in the Agent Native framework provide useful implementation donors."
+remains: "Content needs typed aggregations, multi-dimensional grouping, Pivot, a shared Chart specification and renderer library, saved Chart Views, embeddable Chart Blocks, and drill-down to canonical records."
+required_capabilities:
+  [
+    "content.view.grouping-aggregation",
+    "content.view.pivot",
+    "content.view.chart",
+    "content.access.safe-aggregate",
+  ]
+enhancing_capabilities: ["content.renderer.typed", "content.view.query"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 22: Understand what your data says
+
+Use Charts, Pivots, grouping, measures, and drill-down without creating a separate analytics datastore.
+
+## Product contract
+
+- **Multiple grouping dimensions:** Partitions typed Query results consistently across Views.
+- **Measures and totals:** Compute access-safe counts, sums, averages, subtotals, and grand totals.
+- **Charts:** Share one typed chart specification and renderer toolkit with Agent Native Analytics.
+- **Pivot:** Places dimensions on rows and columns with typed aggregations in cells.
+- **Drill-down:** Opens the canonical records behind an aggregate instead of turning cells into independent data.
+- **Accessible summaries:** Explains the chart or pivot meaning beyond color, shape, or pointer interaction.
+- **Static fidelity:** Preserves useful output in public Pages, presentations, and exports.

package/corpus/templates/content/docs/product/features/content.feature.when-this-happens-that-follows.md

@@ -0,0 +1,43 @@
+---
+record_type: "feature"
+id: "content.feature.when-this-happens-that-follows"
+number: 17
+name: "When this happens, that follows"
+chapter: "content.chapter.working-systems"
+order: 17
+roadmap_status: "partially_implemented"
+summary: "React to committed Events with visible, governed Actions, retries, notifications, and receipts."
+example_workflow: "When a qualified lead enters a Database, a Rule assigns the owner, asks an agent for a bounded summary, sends the right notification, and leaves one receipt showing every action and retry."
+works_today: "Shared Actions, audit history, a framework scheduler, notifications, Automations, provider effects, and active Event and Rule work already cover much of the execution substrate."
+remains: "Content needs one durable Event spine and Rule model with atomic claims, retries, idempotency, agent effects, notification routing, receipts, and a humane inspection surface."
+required_capabilities:
+  [
+    "content.event.committed",
+    "content.rule.deterministic",
+    "content.agent.action-parity",
+  ]
+enhancing_capabilities:
+  [
+    "content.automation.scheduled",
+    "content.action.button",
+    "content.agent.automation",
+  ]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 17: When this happens, that follows
+
+React to committed Events with visible, governed Actions, retries, notifications, and receipts.
+
+## Product contract
+
+- **Events:** Provide atomic facts about what committed, who or what caused it, and which objects changed.
+- **Rules:** Match typed conditions after commit without becoming a second expression or permission engine.
+- **Actions:** Invoke the same operations available to the interface and agents.
+- **Schedules and heartbeats:** Use the framework's single scheduler for time-based conditions and missed-run policy.
+- **Buttons:** Give owners an explicit interface for invoking governed Actions with known inputs and consequences.
+- **Agent effects:** Delegate bounded work without granting the Rule more authority than its actor or policy permits.
+- **Receipts and retries:** Preserve exactly-once claims, crash recovery, honest skips, and queryable outcomes.

package/corpus/templates/content/docs/product/features/content.feature.work-across-every-workspace.md

@@ -0,0 +1,37 @@
+---
+record_type: "feature"
+id: "content.feature.work-across-every-workspace"
+number: 11
+name: "Work across every workspace"
+chapter: "content.chapter.connected-sources"
+order: 11
+roadmap_status: "partially_implemented"
+summary: "Search and save Queries across Personal and organization contexts without widening anyone's access."
+example_workflow: "A person searches their current Workspace, deliberately expands to all accessible contexts, saves a Query spanning Personal and two organizations, and shares it with someone who sees only their own authorized intersection."
+works_today: "Content has Personal and organization spaces, Workspace membership, scoped access checks, and the beginnings of cross-space navigation and search."
+remains: "Active working context must separate cleanly from retrieval scope, while global Home, cross-context Queries, counts, aggregates, and viewer-specific evaluation need complete implementation."
+required_capabilities:
+  [
+    "content.workspace.multi-scope",
+    "content.query.object",
+    "content.access.visibility-closure",
+  ]
+enhancing_capabilities: ["content.home.global", "content.organization.teams"]
+increments: []
+feature_proof: null
+publicness: "public"
+last_reviewed: "2026-07-29"
+---
+
+# Feature 11: Work across every workspace
+
+Search and save Queries across Personal and organization contexts without widening anyone's access.
+
+## Product contract
+
+- **Active context:** Determines where new work is created and which organization or Personal surface governs it.
+- **Retrieval scope:** Can widen deliberately beyond the active context without moving or re-authorizing objects.
+- **Cross-workspace Search:** Expands from the current Workspace to every accessible context through an explicit control.
+- **Cross-workspace Queries:** Save durable, shareable definitions that retain each source object's location and provenance.
+- **Viewer evaluation:** Shows every reader only the intersection they can access, including counts and aggregates.
+- **Global Home:** Composes authorized recent work, Queries, and dashboards without pretending everything belongs to one giant Workspace.