# Yemaya Study & Deconstruction Workspace — SOTA Implementation Checklist > Source specification: > [YEMAYA_STUDY_AND_DECONSTRUCTION_WORKSPACE_PROPOSAL.md](./YEMAYA_STUDY_AND_DECONSTRUCTION_WORKSPACE_PROPOSAL.md) > > Purpose: decompose the complete proposal into granular, independently > verifiable tasks that a coding agent can execute to deliver the full > state-of-the-art vision. This checklist covers the first coherent release and > the broader multi-media, learning, collaboration, production-transfer, and > ecosystem vision. It is not limited to the proposal's first-release roadmap. > > Status on 2026-09-18: 98% of the boxes are checked; the nineteen that are open > are listed by `./eve next yemaya-study-workspace` or parked in > `TODOS/PARKED.md`. (The line that stood here said every checkbox was > intentionally unchecked; that was the initial state.) Existing primitives > cited by the proposal are reuse candidates, not proof that an end-to-end > checklist item is complete. > > Execution process: this checklist is executed under the repository's > sequential task-verification rules (one item, one code-level verification, one > mark — see CLAUDE.md). Standing rules YSD-0001–YSD-0021 below are continuous > constraints that bind every checklist item; they are deliberately not > checkboxes and are verified by the Section 22.3 completion audit rather than > checked off once. --- ## How to execute this checklist ### Checkbox completion contract The rules in this section and in "Required delivery order" are standing constraints, not completable acceptance items: they apply to every checklist item for the life of the program. They keep their YSD IDs so evidence logs and review notes can cite them, but they are never marked done; the Section 22.3 audit verifies continuous adherence instead. - YSD-0001 Treat each checkbox as an atomic acceptance claim; never batch-mark adjacent items because related code exists. - YSD-0002 Before starting an item, inspect the current implementation, linked proposal section, owning-domain contracts, tests, migrations, feature flags, and operational runbooks. - YSD-0003 Record the implementation commit, test command, passing output, reviewer or approval evidence, and any generated artifact beside the item or in a linked evidence log before marking it complete. - YSD-0004 Require production code rather than stubs, fixtures, TODO-only branches, hard-coded success, in-memory-only persistence, or UI-only simulations unless the item explicitly requests a test double. - YSD-0005 Require every state-changing workflow to have authorization, validation, idempotency or concurrency behavior, durable persistence, auditability, error handling, and deletion/expiry behavior. - YSD-0006 Require every machine-generated output to carry source anchors, analysis-run identity, model or code version, configuration, confidence, rights dependencies, and review state. - YSD-0007 Require every user-facing workflow to cover loading, empty, partial, success, validation, permission-denied, rights-denied, offline, retry, cancellation, and destructive-confirmation states where relevant. - YSD-0008 Require unit, schema, contract, integration, migration, authorization, accessibility, observability, and end-to-end tests in proportion to the item; do not treat a narrow unit test as proof of an end-to-end requirement. - YSD-0009 Require telemetry and logs to omit source text, private media URLs, learner responses, biometric-like features, secrets, and prohibited content by default. - YSD-0010 Require documentation, OpenAPI or event-contract updates, operator guidance, and user guidance in the same change as the behavior they describe. - YSD-0011 Require a migration and rollback or forward-fix plan for schema, contract, index, event, rights-policy, and stored-analysis changes. - YSD-0012 Re-run affected lint, typecheck, unit, integration, contract, accessibility, Playwright, security, performance, and build gates before marking an item complete. - YSD-0013 Keep accepted records immutable through versioned supersession; do not overwrite scholarly, rights, review, or creative-decision history. - YSD-0014 Preserve one canonical source of truth per domain and consume it through an adapter; do not copy another domain's engine or taxonomy into Yemaya. - YSD-0015 Mark an external-decision item complete only when the repository contains the decision artifact, named approver, date, rationale, alternatives, consequences, and machine-enforced outcome. ### Priority, phase, and evidence conventions - Inline tagging policy: only P0 (a blocking contract, rights, security, or architecture prerequisite) and P1 (the walking skeleton, YSD-1030) are tagged on individual items. All other items intentionally carry no inline phase tag; their delivery-phase membership is defined by the Section 19 phase groupings (YSD-19001–YSD-19145), which are the canonical statement of what ships in each phase, together with the Required delivery order rules YSD-0016–YSD-0021. - P0 means a blocking contract, rights, security, or architecture prerequisite. - P1 means the manual-first walking skeleton and first coherent release. - P2 means reliable structural automation. - P3 means film craft lenses and the performance atlas. - P4 means video-only and instrumented game study. - P5 means learning, collaboration, outcome evidence, and project transfer. - P6 means advanced analysis, third-party ecosystem, and enterprise operation. - EXT marks a decision that needs product, legal, safety, domain-expert, or customer approval. A coding agent still owns drafting the artifact, building the decision harness, recording the result, and enforcing it in code. EXT appears on the Section 0.2 decisions and on the explicitly tagged items YSD-14206, YSD-18002, YSD-19025, YSD-19106, YSD-19124, YSD-20030, and YSD-20036; treat any other item that turns out to need external approval as EXT and tag it when discovered. - Evidence for a completed item should identify: files changed, tests run, representative fixture or gold-set slice, runtime or rendered proof when applicable, and the commit present on origin/main. ### Required delivery order - YSD-0016 Complete P0 decisions and shared contracts before implementing production analyzers or permanent storage shapes. - YSD-0017 Ship the Phase 1 walking skeleton—one authorized local-file class, rights decision, real persistence, player, hierarchy, manual annotation, notebook, export, and deletion—before parallel feature expansion. - YSD-0018 Keep manual study usable before and during optional analysis; never make model availability a prerequisite for source inspection or annotation. - YSD-0019 Introduce automation only after source-bound outputs, correction, calibration, audit, versioning, and partial-failure behavior exist. - YSD-0020 Do not enable project transfer until rights, abstraction, source-concentration, overly-specific-expression, and dependency-impact checks are enforced. - YSD-0021 Do not open third-party lens or taxonomy extension points until permission filtering, contract conformance, sandboxing, provenance, and quality gates are production-ready. --- ## 0. Scope, ownership, decisions, and program controls ### 0.1 Scope and current-state baseline - [x] YSD-0101 Create a machine-readable capability inventory for Yemaya, Nisaba, Sophia, Hathor, Aja, Euterpe, Aglaea, Bellona, Neith, Maya, Metis, Isis, Iris, and Oshun, including owner, API, data authority, maturity, persistence, fixture use, test coverage, and known limitations. - [x] YSD-0102 Validate every repository-evidence link in proposal Section 29; replace stale paths and record the exact reusable symbols, services, and contracts rather than relying on directory-level claims. - [x] YSD-0103 Build a reuse-versus-wrap-versus-replace ledger for each primitive cited in proposal Section 5.2 and require an owner decision for every partial or fixture-backed capability. - [x] YSD-0104 Inventory all existing media, annotation, notebook, evidence, rights, search, graph, learning, replay, telemetry, signing, and audit schemas and identify incompatible identities or duplicated semantics. - [x] YSD-0105 Inventory existing databases, object stores, queues, search indexes, vector stores, graph projections, time-series stores, and audit systems available to the workspace. - [x] YSD-0106 Inventory current Oshun Studio routes, shared navigation, authentication, tenant context, Library persistence, design tokens, responsive layouts, and accessibility primitives. - [x] YSD-0107 Inventory available Playwright, accessibility, contract, evaluation, performance, deletion, privacy, and security harnesses and map each to the release gates in this checklist. - [x] YSD-0108 Create a source-format support matrix for film/video, audio, subtitles, transcripts, images, documents, storyboards, telemetry, creator-owned 3D assets, level scenes, commentary, and paratext. - [x] YSD-0109 Create a user-persona acceptance matrix covering learner filmmaker, learner game developer, actor/animator/director, character/costume/concept artist, teacher/mentor/team lead, and researcher/critic. - [x] YSD-0110 Create a proposal traceability ledger mapping every normative requirement in Sections 1–29 to checklist task IDs, implementation artifacts, test evidence, and release gates. - [x] YSD-0111 Add an automated traceability check that fails when a normative proposal requirement has no checklist mapping or when a checklist task references a nonexistent source section; match task IDs with exact word-boundary comparison, because four-digit IDs such as YSD-1002 are string prefixes of five-digit IDs such as YSD-10020. - [x] YSD-0112 Establish an implementation evidence log with immutable links to commits, migrations, API versions, evaluation reports, performance runs, accessibility reports, threat-model updates, and release decisions. - [x] YSD-0113 Assess which existing Nisaba primitives (annotations, editions, comparative structures, corpora, study plans) generalize from textual scholarship to time-based media study, which require new Nisaba-owned contracts, and record each outcome in the reuse ledger; Nisaba's current edition model describes critical editions of texts, not media cuts or builds, so do not treat philology-shaped primitives as proof of media-study readiness. ### 0.2 Architecture and product decisions - [x] YSD-0120 P0 EXT Draft and approve an ADR naming Yemaya as creator-facing experience owner, Nisaba as durable study/notebook substrate, Sophia as evidence/provenance substrate, and domain teams as lens owners. - [x] YSD-0121 Encode the approved ownership boundaries in Nx tags, dependency constraints, CODEOWNERS, contract namespaces, service ownership metadata, and architecture tests. - [x] YSD-0122 P0 EXT Decide and record the canonical route—recommended /studio/study versus /studio/yemaya/study—and include redirect, deep-link, analytics, and migration consequences. - [x] YSD-0123 P0 EXT Select the first customer segment from individual creator, classroom, studio team, or internal production and record the resulting tenancy, moderation, consent, and onboarding requirements. - [x] YSD-0124 P0 EXT Select the first source posture from local/owned files, approved provider integrations, or both; document region-specific legal constraints and the fallback when provider authorization is unavailable. - [x] YSD-0125 P0 EXT Approve the rights-policy decision tree, legal-review escalation, allowed-action vocabulary, blocked-action defaults, and service objectives for expiry and deletion. - [x] YSD-0126 P0 EXT Select and document the initial film lens set; evaluate the proposal's recommended playback/annotation, camera, performance, narrative, and sound set, with costume and animation following. - [x] YSD-0127 P0 EXT Confirm the first owned game integration; evaluate V2 against other candidates using replay, telemetry, build access, privacy, instrumentation effort, and representative-gameplay criteria. - [x] YSD-0128 P0 EXT Approve the shared anchor, epistemic, analysis-run, rights, source-version, inspiration, cross-reference, original-concept, and creative-decision contracts before analyzer work begins. - [x] YSD-0129 P0 EXT Select authoritative persistence and rebuildable projection technologies using measured capacity, latency, operability, backup, data-residency, and deletion requirements. - [x] YSD-0130 P0 EXT Secure and record the licensing posture, allowed derivatives, evaluation uses, and expert-review terms for the initial gold sets and seeded corpora. - [x] YSD-0131 P0 EXT Define private/local model execution, enterprise data-residency, offline processing, and provider substitution requirements. - [x] YSD-0132 P0 EXT Approve project-transfer originality policy, prohibited export classes, warning thresholds, escalation paths, and non-legal-advice language. - [x] YSD-0133 P0 EXT Approve the initial typed cross-reference vocabulary, directionality, inverse relations, review states, identity-versus- similarity rules, and taxonomy-governance process. - [x] YSD-0134 P0 EXT Choose the first original-project concept systems and decide which diversity, concentration, consistency, missing-perspective, and over-specificity warnings ship. - [x] YSD-0135 P0 EXT Choose and document the collaboration conflict model across co-annotation, offline queues, and live sessions: CRDT, lock/lease, or an explicitly bounded hybrid. - [x] YSD-0136 P0 EXT Decide mandatory launch interchange targets for annotation, NLE, DCC, game-engine, learning, citation, and teaching-pack workflows. - [x] YSD-0137 P0 EXT Define teacher moderation, learner challenge, study-pack publication, harassment response, and institutional-control policies. - [x] YSD-0138 P0 EXT Prioritize the initial inspiration workflow among character, environment, world, camera, narrative, sound, and mechanic systems using user research and prototype evidence. - [x] YSD-0139 Publish the decision log in the repository and add a CI check preventing production rollout while a blocking decision remains unresolved or expired. ### 0.3 Domain responsibility enforcement - [x] YSD-0150 Define versioned adapter boundaries for all accountable owners in the proposal's responsibility matrix. - [x] YSD-0151 Define Yemaya responsibilities for workspace composition, project lifecycle, project-specific inspiration, original concepts, creative decisions, and project transfer without taking over domain engines. - [x] YSD-0152 Define Nisaba responsibilities for study semantics, source- grounded comparison, annotation, typed links, notebooks, commentary, and research continuity. - [x] YSD-0153 Define Sophia responsibilities for stable evidence anchors, citations, provenance, retrieval, confidence-bearing claims, rights dependencies, and source lineage. - [x] YSD-0154 Define Hathor responsibilities for narrative, character, dramatic structure, directing, cinematography theory, and MDA lens outputs. - [x] YSD-0155 Define Aja responsibilities for video, region annotation, tracking, pose, motion, action, animation reference, and correction semantics. - [x] YSD-0156 Define Euterpe responsibilities for voice, dialogue sound, music, rhythm, listening, sound-event, and mix-analysis outputs. - [x] YSD-0157 Define Aglaea responsibilities for garments, fabric, accessories, construction, material, fashion history, and cultural terminology. - [x] YSD-0158 Define Bellona and product-runtime responsibilities for signed session manifests, replay, engine state, gameplay events, telemetry, and trustworthy synchronization, and for the DCC/engine bridge—the Unreal/Unity/Godot/Blender/Houdini/Maya/DaVinci adapters, interchange, and DCC/engine backlinks that Sections 5, 9.13, 12.2, and 15.4 consume—reusing Bellona's existing bridge libraries rather than building parallel integrations. - [x] YSD-0159 Define Metis responsibilities for concept prerequisites, curricula, exercises, rubrics, assessment, feedback, spaced review, mastery, and portfolios. - [x] YSD-0160 Define Isis responsibilities as an approved inference/generation gateway that returns versioned outputs but never becomes the evidence, notebook, or rights system of record. - [x] YSD-0161 Define Oshun responsibilities for identity, authentication, tenancy, permissions, Studio navigation, Library continuity, audit infrastructure, and shared collaboration behavior. - [x] YSD-0162 Define Iris responsibilities for accessibility policy, assistive alternatives, accessible visualization semantics, and learning accommodations. - [x] YSD-0163 Add adapter conformance tests proving domain-native IDs and anchors survive round trips without lossy re-identification. - [x] YSD-0164 Add architecture tests that reject direct cross-domain database access, copied taxonomies, unapproved model calls, or bypasses around Sophia/Nisaba canonical stores. - [x] YSD-0165 Define Neith and Maya engine-domain responsibilities for the sandboxed 3D asset, material, scene, and level parsing and inspection primitives that Section 9.13 consumes; the workspace must reuse their existing mesh, UV, material, rig, scene-graph, and USD/interchange capabilities through adapters and must not reimplement engine-grade geometry or scene inspection inside Yemaya. --- ## 1. Repository, service, and delivery foundations ### 1.1 Project scaffolding and boundaries - [x] YSD-1001 P0 Create or supersede the architecture ADR for the Study & Deconstruction Workspace, including the logical architecture, domain boundaries, data authority, trust boundaries, route placement, deployment topology, and migration path from specialist apps. - [x] YSD-1002 Scaffold the canonical Studio route under apps/oshun/web/src/app/studio/study/ using the approved routing and layout conventions. - [x] YSD-1003 Scaffold apps/yemaya/svc-study-workspace/ with health, readiness, graceful shutdown, configuration validation, request IDs, structured logging, tracing, metrics, and deployment manifests. - [x] YSD-1004 Scaffold libs/yemaya/study-workspace/ for client-neutral use cases, orchestration policies, normalized read models, and dependency interfaces. - [x] YSD-1005 Add shared, versioned contracts in the approved libs/contracts namespaces without introducing duplicate domain-owned types. - [x] YSD-1006 Create domain adapter packages under their accountable owners and expose explicit capability discovery plus unsupported responses. - [x] YSD-1007 Wrap or evolve apps/aja/svc-reference-video behind the Aja adapter; do not fork its source or fabricate product-ready behavior over its simulated paths. - [x] YSD-1008 Register projects, package manifests, TypeScript configs, path aliases, Nx targets, tags, ownership metadata, and dependency constraints. - [x] YSD-1009 Add schema generation, API client generation, event-contract generation, and compatibility checks to affected CI. - [x] YSD-1010 Add targeted CI workflows for contracts, service, web, migrations, adapter conformance, deletion, accessibility, Playwright, security, evaluation, and performance suites. - [x] YSD-1011 Create local-development composition for PostgreSQL, object storage, jobs/events, search/vector projections, graph projection, and observability with safe test defaults. - [x] YSD-1012 Add environment schemas for every service and client setting; fail startup on missing or mutually inconsistent production values. - [x] YSD-1013 Separate secrets, source credentials, signing keys, provider tokens, model credentials, and user-export data in configuration and secret stores. - [x] YSD-1014 Add feature flags and kill switches per source class, analyzer, provider, export type, game connector, graph suggestion mode, live session, and project-transfer destination. - [x] YSD-1015 Define supported desktop, browser, hardware, media-decoder, assistive-technology, locale, and network baselines for test matrices. - [x] YSD-1016 Create deterministic fixture factories for sources, editions, rights grants, tracks, anchors, epistemic objects, graphs, attempts, sessions, and deletion cases without embedding restricted media. - [x] YSD-1017 Add an adversarial stub scan that rejects placeholder success, hard-coded fixture payloads in production paths, empty adapters, ignored authorization, unimplemented destructive operations, and silent catches. - [x] YSD-1018 Document local setup, seed loading, source-safe fixtures, targeted verification, troubleshooting, and cleanup. ### 1.2 Walking-skeleton delivery - [x] YSD-1030 P1 Implement one authorized local-file source class end to end through authenticate, authorize, identify, ingest, normalize, persist, play, annotate, notebook, export, and delete. This is the same deliverable Section 19.2 ships as YSD-19020; verify once and mark both together. - [x] YSD-1031 Persist the walking skeleton in the real authoritative stores; prohibit in-memory repositories outside tests. - [x] YSD-1032 Enforce rights denial before playback, processing, search, sharing, export, and project transfer in the walking skeleton. - [x] YSD-1033 Make manual hierarchy correction and annotation available as soon as source metadata is sufficient, without waiting for optional analysis. - [x] YSD-1034 Preserve the source-to-anchor-to-observation-to-notebook trail through save, reload, permission changes, and application restart. - [x] YSD-1035 Implement expiry and user-requested deletion across original, proxy, thumbnail, search, vector, graph, cache, notebook preview, and export references in the walking skeleton. - [x] YSD-1036 Add deep Playwright coverage for create project, ingest, rights decision, play, navigate, annotate, compare, pin region, create typed link, save notebook, export, deny action, expire, and delete. - [x] YSD-1037 Add keyboard-only and screen-reader-critical Playwright assertions for the same walking-skeleton journey. - [x] YSD-1038 Run the walking skeleton against at least one real rights-cleared film/video source and retain sanitized execution evidence. - [x] YSD-1039 Demonstrate no-AI operation and explicit unsupported/unavailable analyzer states in an end-to-end test. --- ## 2. Shared identity, evidence, and knowledge contracts ### 2.1 Contract-wide primitives - [x] YSD-2001 Define branded identifiers for every core entity, analysis run, rights decision, review, domain-native object, event, export, and production backlink. - [x] YSD-2002 Define a common immutable record envelope with schema version, tenant, project, creator, timestamps, revision, supersession, provenance, and deletion state. - [x] YSD-2003 Define rational frame-rate, drop-frame timecode, monotonic time, wall-clock, normalized-coordinate, pixel-coordinate, spatial-coordinate, document-coordinate, and runtime-event locator primitives. - [x] YSD-2004 Define author identity as human, model, imported system, or collaborative group without conflating model identity with a user. - [x] YSD-2005 Define review states suggested, accepted, corrected, contested, rejected, and superseded with legal state transitions and immutable review events. - [x] YSD-2006 Define calibrated confidence with value, calibration set, uncertainty or interval, applicability boundary, and missing-confidence semantics. - [x] YSD-2007 Define capability, unsupported, unavailable, forbidden, insufficient-rights, partial-success, and degraded response contracts. - [x] YSD-2008 Publish JSON Schema, OpenAPI, runtime validation, generated client, canonical example, negative example, and backward-compatibility tests for each shared contract. - [x] YSD-2009 Add property-based round-trip tests across service and client serializers, including unknown optional fields and prior supported schema versions. - [x] YSD-2010 Add compatibility policy and automated breaking-change detection for contracts, events, taxonomies, saved views, and portable exports. ### 2.2 Core entity contracts - [x] YSD-2020 Define StudyProject with members, purpose, curriculum, policies, sources, notebooks, collections, target projects, archive state, and membership history. - [x] YSD-2021 Define StudyQuestion with question text, lifecycle open/under- investigation/answered/abandoned, scope, originating context, linked evidence, comparisons, collections, exercises, and resolution history. - [x] YSD-2022 Define SourceWork as canonical work identity independent of any copy while preserving ambiguity and human merge review. - [x] YSD-2023 Define SourceEdition with cut/build/patch/platform/region/ language/frame-rate/aspect/color/audio/subtitle identity and immutable technical revision. - [x] YSD-2024 Define EditionAlignmentMap with endpoint versions, method, confidence, correspondences, explicit gaps, reorder/add/remove semantics, review state, and anchor-migration proposals. - [x] YSD-2025 Define SourceAsset for file, authorized stream reference, transcript, subtitle, still, telemetry bundle, document, commentary, project asset, scene, and sidecar metadata. - [x] YSD-2026 Define RightsGrant with authority, evidence, parties, territory, validity, actions, limits, consent, attribution, legal basis, reviewer, audit, revocation, and retention. - [x] YSD-2027 Define MediaTrack for video, audio, subtitle, transcript, telemetry, camera, animation, gameplay, commentary, and custom synchronized streams. - [x] YSD-2028 Define Segment with medium-specific kind, hierarchy, source revision, segmentation version, temporal/spatial locator, author, confidence, and human corrections. - [x] YSD-2029 Define EvidenceAnchor with exact source locator, permitted representation, acquisition provenance, rights dependencies, review state, immutable version, and restore/deep-link data. - [x] YSD-2030 Define StudyEntity for characters, performers, garments, props, locations, cameras, mechanics, levels, sounds, motifs, and extensible domain-owned kinds. - [x] YSD-2031 Define Detection with feature payload, processor, model/code identity, configuration, run, confidence, source anchors, review state, and applicable limitations. - [x] YSD-2032 Define Observation as human-authored visible/audible/source- inspectable description with one or more anchors and explicit scope. - [x] YSD-2033 Define InterpretationClaim with reading, context, supporting evidence, counterevidence, epistemic status, dissent, corpus boundary, limitations, and review history. - [x] YSD-2034 Define CraftHypothesis with reusable proposition, source derivation, causal-strength classification, limitations, counterexamples, intended practice, and contextual applicability. - [x] YSD-2035 Define TaxonomyTerm with owner, vocabulary version, preferred label, aliases, translations, provenance, broader/narrower/related relations, applicability, and migration rules. - [x] YSD-2036 Define ComparisonSet with research question, inclusion logic, exclusions, examples, counterexamples, alignments, layout, corpus boundary, collaborators, and frozen snapshot. - [x] YSD-2037 Define InspirationCollection with creative question, target project/concepts, audience effect, scope, exclusions, views, collaborators, and diversity posture. - [x] YSD-2038 Define InspirationItem with authorized anchor, relevant aspect, intended effect/problem, principle/question, do-not-copy boundary, role, rights, attribution, culture, confidence, review, and version. - [x] YSD-2039 Define CrossReference with typed and optionally directed endpoints, rationale, evidence, counterevidence, author/model, confidence, review, context, rights dependencies, validity, and supersession. - [x] YSD-2040 Define CreativePrinciple with abstracted wording, supporting and contradicting sources, transformation rationale, limitations, review, track record, and project applicability. - [x] YSD-2041 Define OriginalConcept with project-owned identity, concept kind, relationships, rationale, version history, source-independent authorship, and explicit prohibition on masquerading as a source entity. - [x] YSD-2042 Define CreativeDecision with owner, status, rationale, alternatives, constraints, rejected directions, principle/source paths, affected outputs, approvals, review tasks, and immutable revisions. - [x] YSD-2043 Define OutcomeEvidence with intended effect, playtest/screening/ review/release source, consent, anchors, result, interpretation, uncertainty, linked decision, and practice-result epistemic identity. - [x] YSD-2044 Define Notebook and StudyCard contracts for source-grounded narrative, atomic insight, citation, embedded views, publication, versioning, and Nisaba canonical identity. - [x] YSD-2045 Define PracticeExercise with objective, concept, constraints, rubric, examples, rights, expected evidence, accommodations, due state, and assignment context. - [x] YSD-2046 Define PracticeAttempt with learner-owned artifacts, anchors, revisions, feedback, reflection, consent, privacy, and deletion controls. - [x] YSD-2047 Define MasteryRecord with Metis concept, evidence type, uncertainty, assessor, history, and explicit separation from taste or originality scoring. - [x] YSD-2048 Define SpacedReviewItem with source card/claim/term/drill, schedule state, scheduler version, anchors, discrimination target, review history, and rights-permitted derivative references. - [x] YSD-2049 Define ProjectTransfer with abstracted insight, destination, task/artifact, provenance, rights/originality review, blocked content, backlink, and downstream impact identity. - [x] YSD-2050 Define AnalysisRun with pipeline version, processors/models, configurations, source revisions, cost estimate/actual, quality tier, lifecycle, retries, outputs, cancellation, and failures. - [x] YSD-2051 Define ReviewDecision with reviewer authority, action, reason, corrections, prior/new versions, conflict context, timestamp, and audit identity. - [x] YSD-2052 Add fixture builders and golden serialization tests for every entity above, including minimum valid, complete, prior-version, rejected, rights-expired, contested, and superseded cases. ### 2.3 Shared granularity and anchor semantics - [x] YSD-2070 Implement the common hierarchy from study project through work, edition/build, presentation/session, sequence/level, scene/encounter, shot/phase, beat/action/state transition, frame/audio interval/runtime event, region/entity/signal/property, and epistemic object. - [x] YSD-2071 Allow domain-native hierarchy terms without coercing every medium into film vocabulary; preserve shared parent/child, ordering, overlap, locator, and provenance semantics. - [x] YSD-2072 Implement film anchors for reel, act, chapter, sequence, scene, shot, take, beat, line, word, frame, region, language track, rational frame rate, drop-frame timecode, and edition. - [x] YSD-2073 Implement film entity anchors for character, performer, garment, prop, location, camera, speaker, subtitle, transcript, audio stem, music cue, and sound event. - [x] YSD-2074 Implement game identity anchors for title, platform, region, patch, build, settings, mods, capture configuration, and content manifest. - [x] YSD-2075 Implement game session anchors for session, save state, level, checkpoint, encounter, round, phase, input window, action, state transition, frame, and telemetry event. - [x] YSD-2076 Implement game entity anchors for player, character, NPC, camera, object, ability, animation state, quest, economy transaction, UI state, audio event, and technical sample. - [x] YSD-2077 Encode deterministic replay identity where available and video- clock mapping plus synchronization uncertainty where it is not. - [x] YSD-2078 Implement document anchors for document/edition/page/panel/ block/line/word plus rectangular or polygonal regions. - [x] YSD-2079 Implement still-image anchors for image revision, canvas, layer when available, pixel/normalized region, detected entity, palette region, and user guide. - [x] YSD-2080 Implement creator-owned 3D anchors for asset revision, scene, node, mesh, primitive, vertex/face set, UV island, material slot, texture region, bone, socket, morph target, clip, and time sample. - [x] YSD-2081 Implement creator-owned level/scene anchors for world revision, sublevel, actor/entity, component, volume, spline, camera, light, material, and gameplay reference. - [x] YSD-2082 Add validation preventing assumed cross-view identity from appearance alone and requiring uncertainty plus review for identity candidates. - [x] YSD-2083 Add locator canonicalization and equality tests across frame rates, dropped frames, variable-frame-rate proxies, subtitle tracks, transcript tokenization, normalized/pixel regions, and telemetry clocks. - [x] YSD-2084 Add deep-link round-trip tests proving every supported anchor can restore the exact source version, locator, selected entity, and permitted view. ### 2.4 Evidence and epistemic integrity - [x] YSD-2100 Enforce stable work plus edition/build plus asset/session identity on every evidence-bearing record. - [x] YSD-2101 Support compound locators combining time/frame range, region, transcript span, entity, runtime-event range, and document location. - [x] YSD-2102 Generate only policy-permitted evidence representations: thumbnail, crop, waveform, feature vector, transcript excerpt, or provider deep link. - [x] YSD-2103 Capture acquisition method, source revision, processor, model, code, configuration, and derivation lineage on evidence. - [x] YSD-2104 Bind evidence display, processing, collaboration, embedding, export, publication, retention, and transfer to RightsGrant decisions. - [x] YSD-2105 Display calibrated machine confidence without implying interpretive certainty. - [x] YSD-2106 Preserve human, model, imported-system, and group authorship plus immutable change reason and review history. - [x] YSD-2107 Implement and visibly distinguish source fact, detection, observation, interpretation, craft hypothesis, creator statement, and practice result. - [x] YSD-2108 Prevent API, UI, search, synthesis, export, and analytics layers from silently promoting detection to interpretation or interpretation to creator intent. - [x] YSD-2109 Implement governed epistemic statuses directly observed, model-suggested, source-documented, widely established craft convention, one interpretation, contested, speculative, and insufficient context. - [x] YSD-2110 Store support strength, counterevidence, reviewer agreement, corpus boundary, cultural/context bounds, and known limitations for claims. - [x] YSD-2111 Add contradictory-claim and dissent models that allow multiple readings to coexist without last-write-wins suppression. - [x] YSD-2112 Add invariant tests that reject unanchored analysis, observation, claim, comparison item, inspiration item, and feedback item. - [x] YSD-2113 Add invariant tests that reject machine output without run/model version and interpretation without epistemic type and author. ### 2.5 Cross-edition and cross-build mapping - [x] YSD-2130 Build manual authoring and review for exact, approximate, reordered, added, removed, rescored, regraded, and unmapped correspondences. - [x] YSD-2131 Implement proposal generation using authorized audio fingerprints, shot structure, transcript alignment, and telemetry landmarks behind method-specific adapters. - [x] YSD-2132 Store method, model/code version, confidence, source/target versions, review state, and explicit gaps for every correspondence. - [x] YSD-2133 Allow accepted maps to propose—not silently apply—counterpart anchors for annotations, claims, comparisons, and inspiration items. - [x] YSD-2134 Require human confirmation before migrated anchors become accepted and retain the original and target anchor lineage. - [x] YSD-2135 Surface removed, added, reordered, rescored, and regraded material as gaps instead of interpolating across it. - [x] YSD-2136 Support build/patch maps for live-service games and open revalidation tasks when a source build changes. - [x] YSD-2137 Add accuracy, false-correspondence, gap-detection, anchor- migration, and rollback tests across representative cuts and patches. ### 2.6 Typed relationship graph contracts - [x] YSD-2150 Define addressable node kinds for corpus, work, edition/build, sequence, scene, encounter, shot, beat, frame, image, region, entity, material, palette, pose, motion, sound, transcript, runtime event, document passage, claim, principle, original concept, decision, and production artifact. - [x] YSD-2151 Implement relation types identity, similarity, contrast, influence, analogy, shared function, transformation, sequence, evolution, support, contradiction, counterexample, avoidance, derived principle, and informed decision. - [x] YSD-2152 Define directionality, inverses, symmetry, endpoint constraints, transitivity policy, and plain-language labels for every relation. - [x] YSD-2153 Preserve rationale, author or suggesting model, time, confidence, review state, evidence, counterevidence, context bounds, cultural bounds, rights dependencies, validity, and supersession on every edge. - [x] YSD-2154 Keep canvas coordinates and grouping as presentation state; add tests proving spatial proximity never creates an evidence relationship. - [x] YSD-2155 Keep identity suggestions provisional and prohibit visual or audio similarity from automatically merging people, characters, objects, assets, places, cultures, or concepts. - [x] YSD-2156 Implement stable, immutable endpoint versions and reviewed edge supersession when an endpoint changes. - [x] YSD-2157 Define permission-filtered traversal that evaluates every node, edge, preview, and derived result rather than filtering only the root. - [x] YSD-2158 Define bidirectional backlinks, path inspection, bounded neighborhood expansion, filtered traversal, grouping, clustering, saved views, and dependency-impact query contracts. - [x] YSD-2159 Add graph invariants for broken endpoints, orphaned projections, permission leakage, cyclic derivation where disallowed, invalid relation kinds, and supersession continuity. --- ## 3. Persistence, indexing, lifecycle, and recovery ### 3.1 PostgreSQL authoritative model - [x] YSD-3001 Design normalized PostgreSQL schemas for project, question, source, edition, asset, rights, track, segment, anchor, entity, epistemic, comparison, inspiration, graph, learning, transfer, analysis, review, outcome, and audit records. - [x] YSD-3002 Preserve domain-native identifiers and add mapping tables rather than replacing them with workspace-only IDs. - [x] YSD-3003 Add tenant and project scoping, row-level authorization support, immutable revision keys, soft/legal-hold states, and deletion tombstones. - [x] YSD-3004 Add database constraints for contract invariants, legal state transitions, source-version identity, evidence authorization, and supersession uniqueness. - [x] YSD-3005 Add optimistic-concurrency or approved collaboration semantics to every mutable draft while keeping accepted history append-only. - [x] YSD-3006 Implement repositories and transactions for every aggregate; prohibit partial writes that can orphan anchors, rights dependencies, graph edges, attempts, or decision paths. - [x] YSD-3007 Implement cursor pagination, deterministic ordering, bulk operations, and bounded query plans for large projects. - [x] YSD-3008 Add forward migrations, rollback/forward-fix instructions, seed/test data, schema compatibility tests, and zero/low-downtime rollout verification. - [x] YSD-3009 Add explain-plan and index-coverage tests for hot queries, including timeline windows, anchor lookup, graph path, rights impact, deletion impact, and project resume. - [x] YSD-3010 Add repository integration tests against a real PostgreSQL instance for success, duplicate, conflict, rollback, concurrent edit, rights change, expiry, and deletion paths. ### 3.2 Rights-aware object storage - [x] YSD-3020 Define object namespaces and metadata for originals, quarantine, proxies, thumbnails, crops, waveforms, separated stems, analysis artifacts, learner attempts, exports, and temporary work. - [x] YSD-3021 Encrypt objects, isolate tenants/projects, bind access to short- lived signed URLs, and make every URL decision re-check current rights and permissions. - [x] YSD-3022 Enforce content type, size, duration, codec, archive, decompression, pixel, frame-count, and derivative-resolution limits. - [x] YSD-3023 Implement lifecycle policies for quarantine expiry, processing scratch cleanup, source expiry, revocation, retention, legal hold, and confirmed deletion. - [x] YSD-3024 Store checksum, exact-byte identity, source revision, derivation graph, encryption-key version, content credentials, and policy state with each object. - [x] YSD-3025 Add cross-tenant isolation, stale-signed-URL, revoked-grant, partial-upload, interrupted-delete, and restore tests. ### 3.3 Search, vector, graph, and event projections - [x] YSD-3040 Build permission-filtered text/facet indexes for metadata, transcripts, notes, documents, comments, claims, terms, and creator statements. - [x] YSD-3041 Build permitted visual, motion, audio, and semantic vector indexes with model/configuration/source-version and rights metadata. - [x] YSD-3042 Build a relationship graph projection covering source, evidence, entity, motif, comparison, inspiration, original concept, decision, outcome, and claim-evidence paths. - [x] YSD-3043 Build time-series/event storage for high-volume game sessions and processing telemetry only where measured volume justifies it. - [x] YSD-3044 Treat PostgreSQL as authoritative and implement deterministic, resumable, permission-safe projection rebuilds. - [x] YSD-3045 Implement transactional outbox or equivalent delivery semantics so projection updates cannot be silently lost after authoritative writes. - [x] YSD-3046 Record projection version, lag, failure, retry, source policy, and deletion status; alert on stale or permission-inconsistent projections. - [x] YSD-3047 Add rebuild equivalence tests comparing projected query results with authoritative records. - [x] YSD-3048 Add zero-permission-leakage tests across direct results, facets, counts, snippets, nearest neighbors, graph paths, clusters, caches, and saved views. ### 3.4 Audit ledger, deletion, backup, and restore - [x] YSD-3060 Record rights decisions, access, sharing, exports, project transfers, model runs, reviews, identity merges, graph traversals, deletion, restoration, and administrator actions in a tamper-evident audit ledger. - [x] YSD-3061 Implement dependency discovery from a source/grant/anchor through all derivatives, embeddings, indexes, graph projections, notebooks, exports, decisions, outcomes, and production backlinks. - [x] YSD-3062 Implement expiry enforcement that blocks access immediately, cancels prohibited queued work, invalidates caches/URLs, and schedules derivative cleanup. - [x] YSD-3063 Implement deletion as a durable, resumable saga with per-store acknowledgements, retries, service-objective timer, audit evidence, and terminal incomplete/manual-review state. - [x] YSD-3064 Open affected-decision review tasks instead of silently rewriting accepted decisions when evidence expires, is deleted, or is contested. - [x] YSD-3065 Delete or irreversibly detach prohibited previews and embeddings while retaining only legally permitted tombstones and audit evidence. - [x] YSD-3066 Include revision, anchor, claim, inspiration, graph, original- concept, decision, notebook, learning, and rights relationships in backup and point-in-time recovery. - [x] YSD-3067 Test restore into an isolated environment and prove identifiers, rights, supersession, graph paths, audit history, and deletion tombstones remain consistent. - [x] YSD-3068 Add chaos tests for store outage, duplicate delivery, partial delete, failed cache invalidation, expired source during analysis, and restore followed by deletion replay. --- ## 4. Rights, privacy, originality, safety, and security ### 4.1 Rights resolver and policy engine - [x] YSD-4001 Implement RightsGrant fields for authority source/evidence, owner/licensor, authorized party, work/edition/asset, territory, validity/revocation/review dates, policy decision, reviewer, legal basis, and audit history. - [x] YSD-4002 Implement separately controlled actions for playback, frame extraction, proxy generation, transcription, embedding, model analysis, collaboration, teaching, publication, export, model training, and project transfer. - [x] YSD-4003 Implement constraints for resolution, clip duration, storage location, retention, attribution/notice, commercial/non-commercial use, internal/external audience, and participant consent. - [x] YSD-4004 Build a rights resolver that evaluates user, tenant, project, source version, territory, time, action, destination, derivative, collaborator, and policy version. - [x] YSD-4005 Return an inspectable decision with allow/deny/review-required, matched grants, policy rule, reason, limitations, expiry, reviewer, and appeal/correction path. - [x] YSD-4006 Default creator-owned/internal sources to project-policy analysis while separately enforcing participant consent for private performance and gameplay material. - [x] YSD-4007 Enforce exact grants and expiry for explicitly licensed sources. - [x] YSD-4008 Verify public-domain/open-license jurisdiction, license version, attribution, and permitted action before treating the source as open. - [x] YSD-4009 Enforce link-only playback and prohibit download, decryption, or unauthorized persistent derivatives for provider-controlled sources. - [x] YSD-4010 Quarantine user-declared study references from sharing, export, embeddings, and model processing until policy review resolves each item. - [x] YSD-4011 Limit restricted/prohibited sources to permitted metadata-only records or reject them without creating analysis derivatives. - [x] YSD-4012 Build rights correction, renewal, revocation, expiry, takedown, deletion, and audit workflows. - [x] YSD-4013 Add policy simulation and dry-run impact reports before changing a grant or ruleset. - [x] YSD-4014 Add exhaustive policy-table tests for every source class, action, audience, territory, time boundary, consent state, export, derivative, and denial reason. - [x] YSD-4015 Add tests proving no client, BFF, adapter, worker, projection, or export path can bypass the central rights decision. ### 4.2 Copyright and originality safeguards - [x] YSD-4030 Block DRM circumvention, access-control bypass, unauthorized streaming download, process injection, anti-cheat evasion, archive decryption, and protected-asset extraction. - [x] YSD-4031 Enforce grant-specific clip, frame, resolution, quotation, derivative, sharing, and export limits rather than a universal duration rule. - [x] YSD-4032 Preserve attribution, source identity, edition, license state, and provider deep link in every permitted study output. - [x] YSD-4033 Build a reviewable overly-specific-expression detector for project transfers using exact anchors, abstraction level, retained source detail, and policy—not an opaque originality or legal score. - [x] YSD-4034 Build source-concentration and one-to-one mapping warnings for concepts and decisions that rely too heavily on one protected work. - [x] YSD-4035 Require project transfers to carry abstract principles, constraints, questions, or tasks and strip prohibited media, assets, and near-copy prompts. - [x] YSD-4036 Separate analysis/embedding consent from generative-model- training consent and default model training on study sources to off. - [x] YSD-4037 Add adversarial transfer tests for near-copy prompts, extractable visual detail, long clips, high-resolution crops, proprietary game assets, and one-source concept mappings. - [x] YSD-4038 Make warnings advisory and inspectable where the proposal does not authorize blocking; clearly state that the system does not make a legal conclusion. ### 4.3 Performer, learner, and participant privacy - [x] YSD-4050 Restrict rehearsal, audition, classroom, mocap, voice, gameplay, learner-attempt, and review-session media by default. - [x] YSD-4051 Treat face, voice, pose, gait, motion, and other biometric-like derived features as sensitive data in storage, access, logging, export, retention, and deletion. - [x] YSD-4052 Prohibit face recognition, voice identification, demographic inference, mental-health diagnosis, deception detection, and real-state emotion inference in schemas, model registries, APIs, and tests. - [x] YSD-4053 Allow identity labels only from authorized human entry or trusted source metadata and record their origin. - [x] YSD-4054 Implement dedicated minor consent, guardian authority, audience, access, retention, export, publication, and deletion controls. - [x] YSD-4055 Let learners inspect, correct, export, revoke sharing for, and delete their attempts and derived features subject to legitimate retention/legal holds. - [x] YSD-4056 Require audience-compatible consent before using private examples in comparison sets, classes, study packs, evaluation sets, or model improvement. - [x] YSD-4057 Filter player identifiers, chat, voice, network addresses, account IDs, and sensitive telemetry from game-session ingest and analytics. - [x] YSD-4058 Build privacy-safe aggregate thresholds for heatmaps, outcome analytics, product metrics, and institutional reporting. - [x] YSD-4059 Add consent revocation and deletion propagation tests, including already-shared views, generated drills, cached previews, and aggregate minimum-group behavior. ### 4.4 Epistemic, cultural, and dignity safeguards - [x] YSD-4070 Require behavior-specific language in model prompts, UI copy, feedback, and exports; reject claims such as real emotional state, diagnosis, or universal emotional truth. - [x] YSD-4071 Keep observation, model suggestion, interpretation, creator statement, and authorial-intent claim visually and semantically distinct. - [x] YSD-4072 Require source-backed cultural and historical claims with taxonomy authorship and applicability limits. - [x] YSD-4073 Support cultural/language variants, counter-readings, dissent, and community review without treating one acting, animation, film, or game tradition as neutral. - [x] YSD-4074 Add harassment, identity-targeting, abusive-comment, and unsafe- classroom moderation controls to shared studies and live sessions. - [x] YSD-4075 Evaluate expression, gesture, gaze, voice, costume, body, and emotion-related outputs across culture, language, skin tone, age, disability presentation, gender expression, performance tradition, and synthetic-media status. - [x] YSD-4076 Add safe-language regression tests that reject mind-reading, global actor ranking, cultural conformity scoring, biometric truth, and opaque emotional-authenticity scores. - [x] YSD-4077 Allow users to contest labels, scores, relations, and feedback; retain the original, correction, rationale, reviewer context, and unresolved disagreement. ### 4.5 Application and ingestion security - [x] YSD-4090 Produce a threat model covering tenant boundaries, project sharing, untrusted files/URLs/documents/transcripts, media parsers, model prompts, provider callbacks, game connectors, live sessions, exports, signing, deletion, and administrator actions. - [x] YSD-4091 Enforce tenant- and project-scoped authorization on originals, derivatives, annotations, embeddings, indexes, graph paths, notebooks, attempts, outcomes, live sessions, and exports. - [x] YSD-4092 Encrypt data in transit and at rest, rotate keys, use short-lived credentials/URLs, separate service identities, and audit privileged access. - [x] YSD-4093 Malware-scan and quarantine files before parser access; sandbox media, archive, document, subtitle, image, model, and 3D parsers with resource limits. - [x] YSD-4094 Protect URL import, provider callbacks, thumbnail retrieval, and link preview from SSRF, DNS rebinding, redirect abuse, local-network access, and credential leakage. - [x] YSD-4095 Enforce size, duration, frame, codec, archive depth, decompression ratio, image dimension, mesh complexity, telemetry volume, and parser timeout limits. - [x] YSD-4096 Isolate untrusted transcript, subtitle, document, commentary, imported metadata, and web content from system prompts and model tools. - [x] YSD-4097 Prevent secrets, tokens, signed URLs, private prompts, hidden metadata, and internal policy from notebooks, logs, exports, analytics, and model-visible context. - [x] YSD-4098 Add tenant/user/project/lens/provider rate, GPU, storage, concurrency, export, and monetary cost limits. - [x] YSD-4099 Add SAST, dependency, secret, container, IaC, parser fuzz, authorization, prompt-injection, SSRF, archive-bomb, and cross-tenant security tests to CI. - [x] YSD-4100 Add incident runbooks and alerts for authorization leakage, malware escape, parser crash loops, prompt injection, provider compromise, leaked export, signing failure, and stuck deletion. ### 4.6 Content authenticity and synthetic media - [x] YSD-4120 Verify C2PA credentials at ingest when present and store manifest, signer, validation result, validation tool/version, and source revision as source facts. - [x] YSD-4121 Treat missing credentials as unknown provenance, never proof of authenticity or manipulation. - [x] YSD-4122 Record declared or responsibly detected AI-generated and AI- modified status with method, confidence, review, and limits. - [x] YSD-4123 Propagate synthetic-media status into search, comparisons, atlases, evaluation slices, synthesis, notebooks, and exports. - [x] YSD-4124 Prevent synthetic and captured performances from being silently pooled in analyses or outcome claims. - [x] YSD-4125 Sign permitted study packs, notebooks, learner attempts, and portable manifests with the shared content-signing capability. - [x] YSD-4126 Verify signed outputs on import and preserve signature lineage through allowed transformations. - [x] YSD-4127 Add tampered, missing, expired, unsupported, multiple-manifest, and re-signed content-credential test fixtures. --- ## 5. Source acquisition, normalization, and analysis orchestration ### 5.1 Source acquisition surfaces - [x] YSD-5001 Implement resumable, checksum-verified local file upload with pause/resume, duplicate detection, progress, cancellation, quota enforcement, and safe restart. - [x] YSD-5002 Implement creator-owned/internal asset registration with project identity, participant consent, retention, DCC/engine backlinks, and authorized deep inspection. - [x] YSD-5003 Implement authorized game-capture import for video, audio, optional input overlay, capture settings, patch/build, platform, mods, device, network, and accessibility settings. - [x] YSD-5004 Implement provider deep-link registration and authorized playback without copying restricted media; represent unavailable provider capabilities honestly. - [x] YSD-5005 Implement public-domain/open-license ingest with jurisdiction, license version, attribution, source verification, and derivative limits. - [x] YSD-5006 Implement licensed-source ingest with grant attachment, territory, collaborator audience, expiry, and allowed-derivative enforcement. - [x] YSD-5007 Implement metadata-only or rejected source records for restricted/prohibited material without creating unauthorized previews, embeddings, transcripts, or analysis. - [x] YSD-5008 Implement signed instrumented-build session registration with build/content manifest, clock mapping, replay/state references, telemetry schemas, privacy policy, and source authority. - [x] YSD-5009 Implement paratext ingest for commentary tracks, interviews, making-ofs, talks, art books, patch notes, and developer diaries with creator-statement epistemic identity. - [x] YSD-5010 Implement rights-aware imports for PureRef, Milanote, Are.na, Pinterest, and Zotero with item-level provenance, deduplication, quarantine, and per-item review. - [x] YSD-5011 Implement a secure browser clipper that captures source URL, page identity, selected region/text/media, acquisition time, context, rights declaration, and an allowed preview. - [x] YSD-5012 Implement desktop screenshot/region hotkeys that retain source application/file context where available and force rights classification before downstream use. - [x] YSD-5013 Add source-acquisition capability discovery so clients can disable unavailable providers or formats without pretending success. - [x] YSD-5014 Add acquisition contract and end-to-end tests for interrupted upload, duplicate bytes, same work/different edition, expired provider token, disallowed source, quarantine, and revoked consent. ### 5.2 Authorize and identify stages - [x] YSD-5030 Authenticate the actor and resolve tenant, project, membership, role, territory, and requested source action before accepting content. - [x] YSD-5031 Capture source authority, supporting evidence, participant consent, requested uses, retention, collaborators, and a provisional rights classification. - [x] YSD-5032 Invoke the rights resolver before any persistent derivative, model processing, embedding, collaboration, or export. - [x] YSD-5033 Hash exact files and compute safe technical fingerprints for deduplication only within authorized boundaries. - [x] YSD-5034 Resolve SourceWork and SourceEdition/build candidates without silently merging cuts, patches, regional versions, or different masters. - [x] YSD-5035 Present ambiguous work/edition/build identity for human review with supporting metadata and explicit keep-distinct action. - [x] YSD-5036 Store provider-controlled references as externally governed identities with availability/expiry polling and no false byte identity. - [x] YSD-5037 Add identity-resolution evaluation for exact match, near metadata, alternate title, regional version, changed frame rate, remaster, live-service patch, and intentionally distinct sources. ### 5.3 Secure ingest and normalization - [x] YSD-5050 Stream incoming files into quarantine and complete malware, parser, archive, content-type, checksum, and rights checks before promotion. - [x] YSD-5051 Probe container, codecs, tracks, duration, dimensions, rational frame rate, variable-frame-rate behavior, color/mastering, channel layout, subtitles, and embedded metadata using a versioned toolchain. - [x] YSD-5052 Validate and normalize time bases without erasing the original timecode, frame cadence, drop-frame semantics, drift, or discontinuities. - [x] YSD-5053 Generate only rights-permitted tiered proxies, thumbnails, waveforms, tiled images, document canvases, audio previews, and analysis intermediates. - [x] YSD-5054 Align audio, language tracks, subtitles, transcripts, commentary, camera metadata, game telemetry, and replay clocks while recording method, error, drift, gaps, and review state. - [x] YSD-5055 Preserve source color profile, aspect ratio, rotation, pixel aspect, mastering metadata, and display-transform provenance. - [x] YSD-5056 Validate document page order, revisions, OCR layers, panels, blocks, text direction, regions, and embedded media without flattening the original. - [x] YSD-5057 Validate still-image dimensions, color profile, alpha, layers where available, revision identity, EXIF/privacy policy, and tiled-deep- zoom eligibility. - [x] YSD-5058 Validate creator-owned 3D/scene packages for hierarchy, linked resources, units, coordinate system, animation, materials, complexity, unsupported features, and safe sandboxed parsing. - [x] YSD-5059 Validate telemetry bundles against engine-neutral envelope and event schema versions; record dropped, corrupt, out-of-order, duplicated, and unknown events. - [x] YSD-5060 Add golden normalization tests across constant/variable frame rate, drop-frame, multi-audio, RTL subtitle, HDR/SDR, corrupt media, image layers, document revisions, glTF sidecars, and telemetry gaps. ### 5.4 Structural analysis and signal extraction - [x] YSD-5080 Implement versioned hierarchy suggestion for chapters, sequences, scenes, shots, beats, encounters, gameplay phases, document sections, storyboard panels, and asset components. - [x] YSD-5081 Implement transcript and subtitle alignment with speakers, lines, words, language identity, confidence, gaps, and correction. - [x] YSD-5082 Implement visual signal extraction for cuts, fades, color, composition, lighting, focus, objects, regions, people, garments, props, environments, poses, and tracks where approved. - [x] YSD-5083 Implement motion signal extraction for trajectories, joint movement, action phases, contact, timing, and track continuity where approved. - [x] YSD-5084 Implement audio signal extraction for speech, breath, loudness, pitch, rhythm, silence, sound events, ambience, music cues, and mix features where approved. - [x] YSD-5085 Implement technical signal extraction for frame timing, compression, dropped frames/samples, playback constraints, telemetry quality, latency, and runtime performance. - [x] YSD-5086 Bind every signal to stable anchors, analysis run, feature extractor version, confidence, rights policy, and review state before persistence. - [x] YSD-5087 Keep deterministic signals, probabilistic detections, observations, and interpretations in distinct stores and API fields. - [x] YSD-5088 Add human correction for hierarchy, boundaries, speakers, tracks, regions, poses, terms, and alignments with versioned supersession. - [x] YSD-5089 Measure structural analyzers against versioned gold sets and publish precision/recall, calibration, slice failures, and known limits. ### 5.5 Lens orchestration - [x] YSD-5100 Implement capability discovery per domain adapter, source type, rights state, language, track availability, hardware, and quality tier. - [x] YSD-5101 Let users opt in to individual lenses and see input prerequisites, estimated duration, GPU class, storage, monetary cost, rights implications, and expected output. - [x] YSD-5102 Validate source revision, anchors, rights, consent, budget, and adapter capability when scheduling each lens. - [x] YSD-5103 Route work to the accountable domain adapter and preserve its native IDs, taxonomy version, evidence dependencies, model/code version, cost, latency, and limitations. - [x] YSD-5104 Normalize adapter output into workspace read models without discarding domain-specific fields or silently changing epistemic type. - [x] YSD-5105 Return explicit unsupported, unavailable, insufficient-input, insufficient-rights, budget-blocked, partial, and failed states. - [x] YSD-5106 Require high-interpretation outputs to enter suggestion/review state and prevent their automatic promotion to accepted claims. - [x] YSD-5107 Add adapter timeouts, retries, circuit breakers, backpressure, concurrency limits, cost controls, and kill switches. - [x] YSD-5108 Add conformance and fault-injection tests for every domain adapter, including malformed output, missing anchor, stale model, partial response, permission change, timeout, and unavailable dependency. ### 5.6 Durable job behavior - [x] YSD-5120 Implement idempotency for identical source revision, rights- allowed action, pipeline/model/configuration, taxonomy, and code version. - [x] YSD-5121 Model each pipeline stage as independently retryable with structured failure reason, attempt count, backoff, dead-letter handling, and operator recovery. - [x] YSD-5122 Expose progress by source, stage, lens, completed/total units, queue state, cost accrued, and estimated remaining work. - [x] YSD-5123 Publish initial progress within one second and continue heartbeat updates for long jobs. - [x] YSD-5124 Keep manual source inspection and annotation available while optional analysis is queued, running, degraded, or failed. - [x] YSD-5125 Support selectable quality/model tiers within rights, policy, data-residency, hardware, and budget bounds. - [x] YSD-5126 Represent partial success explicitly and preserve validated outputs from successful lenses when another lens fails. - [x] YSD-5127 Implement cancellation that stops downstream work, revokes leases, accounts actual cost, and removes uncommitted derivatives. - [x] YSD-5128 Implement reanalysis as a new immutable run with source/analysis version diff, accepted-output impact, and optional review tasks. - [x] YSD-5129 Detect stale outputs when source, edition map, rights, taxonomy, adapter, model, code, or configuration changes. - [x] YSD-5130 Add job tests for duplicate requests, worker crash, poison payload, retry, partial success, cancellation race, rights expiry mid-run, budget exhaustion, stale output, and outbox replay. ### 5.7 Human-in-the-loop checkpoints - [x] YSD-5150 Route uncertain or insufficient rights to an authorized reviewer and block prohibited downstream work pending resolution. - [x] YSD-5151 Route ambiguous work/edition/build identity to keep-distinct or merge review with supporting evidence. - [x] YSD-5152 Route low-confidence segmentation and synchronization to a correction work queue. - [x] YSD-5153 Route identity-sensitive tracking and private performance processing to consent and access review. - [x] YSD-5154 Route emotion, culture, mental-state, authorial-intent, influence, and other high-interpretation claims to appropriate expert/human review. - [x] YSD-5155 Route material model disagreement above the configured threshold with each model's evidence and calibration context intact. - [x] YSD-5156 Route suggested cross-source identity, cultural equivalence, influence, analogy, or causal relations for explicit accept/reject/ correct/contest/keep-distinct review. - [x] YSD-5157 Route exports and project transfers approaching protected expression to originality/rights review with a traceable warning basis. - [x] YSD-5158 Route publication of shared study packs, exemplars, and learner assessment through consent, rights, accessibility, moderation, and pedagogical review. - [x] YSD-5159 Add reviewer assignment, due state, conflict-of-interest, escalation, evidence bundle, decision rationale, and appeal behavior. ### 5.8 Continuous retain/delete stage - [x] YSD-5180 Re-evaluate rights validity, consent, source availability, retention, and policy changes continuously rather than only at ingest. - [x] YSD-5181 Stop new playback/processing/search/share/export/transfer access immediately when authority no longer permits it. - [x] YSD-5182 Reconcile source and derivative inventories to detect orphaned, over-retained, under-audited, or policy-inconsistent objects. - [x] YSD-5183 Rebuild or purge permission-sensitive projections after rights, consent, identity, or source-version changes. - [x] YSD-5184 Open dependency-impact review for accepted claims, collections, decisions, exercises, and outputs affected by expiry/deletion. - [x] YSD-5185 Publish deletion/expiry service-level metrics, stuck-work alerts, reconciliation reports, and auditable completion receipts. --- ## 6. Orchestrator, adapters, APIs, and events ### 6.1 Orchestrator application responsibilities - [x] YSD-6001 Implement study-project create, read, update, archive, restore, membership, policy, and lifecycle use cases. - [x] YSD-6002 Implement composed source hierarchy without taking ownership of domain-native media or evidence stores. - [x] YSD-6003 Implement lens selection, estimate, schedule, monitor, cancel, reanalyze, and diff orchestration. - [x] YSD-6004 Enforce identity, tenant, project, role, rights, consent, policy, budget, and source-version checks across every cross-domain request. - [x] YSD-6005 Build normalized evidence, epistemic, timeline, graph, comparison, learning, and project-transfer read models. - [x] YSD-6006 Coordinate comparison sets, alignment, snapshots, permissions, collaborative review, and exports. - [x] YSD-6007 Coordinate inspiration collections, items, views, typed cross-references, original concepts, creative principles, and decisions. - [x] YSD-6008 Calculate dependency and change impact across sources, grants, anchors, claims, principles, concepts, decisions, outputs, outcomes, and exports. - [x] YSD-6009 Coordinate rights-safe project transfers and preserve destination backlinks plus downstream status. - [x] YSD-6010 Aggregate API responses for the Studio route with bounded fan-out, partial-response semantics, timeouts, and cache policy. - [x] YSD-6011 Add service-level unit, repository, contract, integration, authorization, concurrency, idempotency, partial-failure, and chaos tests. ### 6.2 Domain adapter conformance - [x] YSD-6030 Publish a versioned input/output envelope and capability list for Nisaba study/notebook operations. - [x] YSD-6031 Publish a versioned input/output envelope and capability list for Sophia evidence, provenance, rights, retrieval, and citations. - [x] YSD-6032 Publish a versioned input/output envelope and capability list for Aja media, region, pose, motion, action, and annotation operations. - [x] YSD-6033 Publish a versioned input/output envelope and capability list for Hathor narrative, character, directing, cinematography, and MDA lenses. - [x] YSD-6034 Publish a versioned input/output envelope and capability list for Euterpe audio, voice, music, rhythm, and sound lenses. - [x] YSD-6035 Publish a versioned input/output envelope and capability list for Aglaea costume, fabric, accessory, material, and fashion-history lenses. - [x] YSD-6036 Publish a versioned input/output envelope and capability list for Bellona game sessions, replay, telemetry, engine state, and event tracks. - [x] YSD-6037 Publish a versioned input/output envelope and capability list for Metis curriculum, exercise, rubric, feedback, review, and mastery. - [x] YSD-6038 Publish a versioned input/output envelope and capability list for Isis inference and approved generation with model routing and policy. - [x] YSD-6039 Publish a versioned input/output envelope and capability list for Iris accessibility requirements and alternative representations. - [x] YSD-6040 Ensure permission filtering occurs before adapter inputs enter search, embeddings, models, caches, or downstream domain services. - [x] YSD-6041 Preserve all upstream anchors, policy dependencies, versions, costs, latency, confidence, and review state in cross-domain derived claims. - [x] YSD-6042 Add consumer-driven contract suites and backward-compatibility matrices for every adapter version. ### 6.3 API platform-wide requirements - [x] YSD-6060 Define OpenAPI contracts with runtime validation, generated clients, stable error taxonomy, pagination, filtering, sorting, sparse field selection, and correlation IDs. - [x] YSD-6061 Enforce authentication, tenant/project authorization, rights, consent, rate/cost limits, and audit logging at the API boundary and again in application use cases. - [x] YSD-6062 Add idempotency keys and conditional revision headers to applicable mutations; return explicit conflict data for concurrent edits. - [x] YSD-6063 Implement asynchronous-operation resources for ingest, analysis, deletion, export, rebuild, and large impact calculations. - [x] YSD-6064 Implement server-sent events or approved streaming transport for job progress, live-session state, review updates, and presence with reconnect/resume behavior. - [x] YSD-6065 Add consistent source/anchor expansion rules that never expose unauthorized previews or hidden graph neighbors. - [x] YSD-6066 Add API fuzz, malformed input, over-fetching, authorization, schema compatibility, N+1, pagination stability, and error-redaction tests. ### 6.4 API groups - [x] YSD-6080 Implement /study-projects for create/list/detail, membership, policy, archive/restore, import/export, and deletion with contract and integration tests. - [x] YSD-6081 Implement /study-questions for lifecycle, scope, linked evidence, unanswered views, resolution, abandonment, and history. - [x] YSD-6082 Implement /sources for add/link, identity candidates, editions, metadata, availability, retention, expiry, deletion, and impact. - [x] YSD-6083 Implement /rights for grant evidence, resolve, simulate, approve, deny, review, correct, renew, revoke, expire, audit, and allowed actions. - [x] YSD-6084 Implement /tracks and /segments for hierarchy, timeline windows, suggestions, corrections, reordering, overlap, alignment, and versions. - [x] YSD-6085 Implement /anchors for temporal, spatial, document, event, transcript, entity, compound locators, permitted snapshots, and deep links. - [x] YSD-6086 Implement /analyses for capability, estimate, request, cancel, progress, partial failure, output versions, stale state, and diffs. - [x] YSD-6087 Implement /observations for create, batch create, revise, correct, review, query by anchor/entity/author, and provenance. - [x] YSD-6088 Implement /claims for interpretations, support, counterevidence, dissent, epistemic status, limitations, contest, and supersession. - [x] YSD-6089 Implement /entities and /taxonomies for domain terms, source identities, aliases, versioned relationships, candidate merge, keep-distinct, and migration. - [x] YSD-6090 Implement /search for hybrid metadata/taxonomy/text/semantic/ visual/motion/audio/runtime/relational query with epistemic, rights, source, and permission filters. - [x] YSD-6091 Implement /comparisons for sets, inclusion/exclusion, counterexamples, alignment, layouts, matrix views, snapshots, collaboration, freeze, publish, and export. - [x] YSD-6092 Implement /inspiration-collections for creative question, target concepts, items, coordinated views, coverage, concentration, collaborators, and versions. - [x] YSD-6093 Implement /cross-references for manual edges, suggestions, rationale, evidence, review, contest, keep-distinct, traversal, saved graph views, and impact. - [x] YSD-6094 Implement /original-concepts for project-native entities, relationships, system maps, consistency questions, coverage, and revisions. - [x] YSD-6095 Implement /creative-decisions for principles, alternatives, transformation rationale, approval, commit, dependencies, backlinks, outcome state, and impact review. - [x] YSD-6096 Implement /notebooks through Nisaba for cards, narratives, citations, embedded views, revision, collaboration, publishing, and portable export. - [x] YSD-6097 Implement /practice for exercises, assignments, attempts, rubrics, accommodations, automated/human/peer feedback, reflection, challenge, and mastery evidence. - [x] YSD-6098 Implement /project-transfers for destination capability, originality/rights review, transformation, blocked content, task creation, backlink, and delivery status. - [x] YSD-6099 Implement /game-sessions for signed manifests, clocks, privacy filters, telemetry, replay, checkpoints, event windows, capture gaps, and reproducible bookmarks. - [x] YSD-6100 Implement /edition-alignments for proposals, manual correspondences, explicit gaps, review, anchor migration, invalidation, and diffs. - [x] YSD-6101 Implement /live-sessions for synchronized playback, presence, roles, anchored discussion, moderation, reconnect, recording policy, and claim crystallization. - [x] YSD-6102 Implement /outcome-evidence for playtest/screening/review/release evidence, intended effect, consent, decision linkage, review, and contextual principle track records. - [x] YSD-6103 Add per-group authorization matrices, OpenAPI examples, generated-client smoke tests, data-leakage tests, and representative end-to-end journeys for all API groups. ### 6.5 Domain events and durable consumers - [x] YSD-6120 Define the event envelope with event ID, schema version, aggregate ID/version, tenant/project, actor, timestamp, correlation/ causation, rights-policy version, sensitivity, trace context, and redaction rules. - [x] YSD-6121 Implement schema-registry compatibility, transactional publication, idempotent consumption, ordering expectations, retry, dead-letter, replay, and deletion/tombstone handling. - [x] YSD-6122 Implement study.project.created publishers, consumers, audit, fixtures, and contract tests. - [x] YSD-6123 Implement study.question.opened and study.question.resolved lifecycle events and unanswered-question projection updates. - [x] YSD-6124 Implement study.source.authorization.requested and study.source.rights.resolved with policy-safe payloads and blocked-work resumption. - [x] YSD-6125 Implement study.source.ingested and study.track.normalized with source-version and track-manifest references. - [x] YSD-6126 Implement study.source.expired and invalidate access, queued work, projections, signed URLs, and affected views. - [x] YSD-6127 Implement study.source.deletion.requested and study.source.deletion.completed with per-store status and audit receipt. - [x] YSD-6128 Implement study.segmentation.proposed and study.segmentation.corrected with analyzer/human provenance and supersession. - [x] YSD-6129 Implement study.edition_alignment.proposed and study.edition_alignment.reviewed with explicit gaps and anchor impact. - [x] YSD-6130 Implement study.paratext.aligned with primary/paratext edition versions, method, confidence, and creator-statement identity. - [x] YSD-6131 Implement study.analysis.requested, study.analysis.completed, and study.analysis.partially_failed with run/configuration/cost/output references. - [x] YSD-6132 Implement study.detection.reviewed, study.observation.created, study.claim.created, and study.claim.contested with authorized anchor references. - [x] YSD-6133 Implement study.comparison.published with frozen corpus, versions, rights decision, dissent, and export references. - [x] YSD-6134 Implement study.live_session.started and study.live_session.crystallized without placing private discussion content into unrestricted events. - [x] YSD-6135 Implement study.inspiration_collection.created and study.inspiration_item.pinned with target project, anchor, rights, and transfer-warning state. - [x] YSD-6136 Implement study.cross_reference.suggested and study.cross_reference.reviewed with rationale, evidence, keep-distinct, and identity-merge safeguards. - [x] YSD-6137 Implement study.original_concept.created and study.creative_decision.committed with project-native identity and immutable dependency paths. - [x] YSD-6138 Implement study.creative_decision.impact_review_requested for source, claim, rights, analysis, decision, and outcome changes. - [x] YSD-6139 Implement study.outcome.evidence_recorded with consent-safe references and principle track-record projection. - [x] YSD-6140 Implement study.notebook.saved with Nisaba canonical revision and citation dependencies. - [x] YSD-6141 Implement study.practice.assigned, study.practice.attempted, and study.mastery.evidence_recorded with privacy, accommodation, and version semantics. - [x] YSD-6142 Implement study.project_transfer.created with rights/originality review and destination backlink. - [x] YSD-6143 Implement study.export.created with rights decision, included/ excluded content manifest, signature, expiry, and audit identity. - [x] YSD-6144 Add event replay tests that rebuild all projections from authoritative records without duplicate effects or historical permission leakage. --- ## 7. Oshun Studio information architecture and shared interaction model ### 7.1 Route, navigation, and workspace shell - [x] YSD-7001 Add the approved Study entry to Oshun Studio global navigation with authorization, feature-flag, active-route, keyboard, localization, responsive, and telemetry behavior. - [x] YSD-7002 Build Home with resume studies, jobs, assignments, reviews, expiring rights, recent findings, unanswered questions, and useful rights-safe empty states. - [x] YSD-7003 Build Sources as a rights-aware library of media, documents, paratexts, game sessions, creator assets, editions, processing state, and retention/deletion actions. - [x] YSD-7004 Build Workbench as the synchronized source, evidence, annotation, lens, timeline, notebook, compare, inspiration, and handoff composition. - [x] YSD-7005 Build Atlas for contextual cross-source collections such as anger, entrances, reveals, hit reactions, transformations, tutorial moments, and user-defined templates. - [x] YSD-7006 Build Compare with two-to-eight-up synchronized focus and an unbounded corpus matrix backed by one ComparisonSet model. - [x] YSD-7007 Build Inspiration with dominant media canvas, contact sheet, corpus matrix, graph, timeline, notebook outline, project concept map, and decision trail as coordinated projections. - [x] YSD-7008 Build Notebooks through Nisaba with cards, narratives, citations, embedded views, drafts, version history, collaboration, and publishing. - [x] YSD-7009 Build Practice with exercises, attempts, rubrics, feedback, reflection, challenge, spaced review, mastery evidence, and portfolio. - [x] YSD-7010 Build Projects for original concepts, decisions, transfers, production backlinks, outcome evidence, impact reviews, and downstream status. - [x] YSD-7011 Build Reports for rights-safe Markdown, PDF, presentation, JSON, CSV, contact-sheet, marker, manifest, teaching-pack, audit, and evaluation outputs. - [x] YSD-7012 Preserve global project/source/edition/version context, current rights state, search, share, export, connection state, and background job status across all areas. - [x] YSD-7013 Add deep-link and browser-history behavior that restores source, exact anchor, lens set, selected entity, view, layout, comparison, permission context, and spoiler state. - [x] YSD-7014 Add route-level loading, not-found, unsupported, no-access, rights-expired, deleted, offline, partial-dependency, and recoverable-error boundaries. ### 7.2 Workbench composition - [x] YSD-7030 Build a source navigator that renders the medium-appropriate hierarchy and supports expansion, correction, filtering, search, uncertainty, and version comparison. - [x] YSD-7031 Build the synchronized media canvas for video, image, document, game replay, waveform, creator-owned 3D, and source-safe provider playback. - [x] YSD-7032 Make source media the dominant working surface; keep navigation and relationship detail secondary and progressively disclosed. - [x] YSD-7033 Build a lens inspector with separate Observe, Interpret, Hypothesize, evidence/confidence, terminology/context, review, and limitations surfaces. - [x] YSD-7034 Build the multitrack timeline for hierarchy, dialogue, performance, camera, motion, sound, music, costume, mechanics, runtime events, analysis, and human annotations. - [x] YSD-7035 Build the notebook/compare/inspiration/project-handoff lower workspace with resize, collapse, detach where approved, and persistent layout. - [x] YSD-7036 Persist selected entity, track, range, lens set, zoom, layout, overlays, comparison state, view, and source version per user/project. - [x] YSD-7037 Keep selected evidence synchronized across media canvas, matrix, graph, timeline, notebook, original-project map, and decision trace. - [x] YSD-7038 Build independent overlay toggles, presets, opacity, legends, z-order, conflict handling, and performance throttling. - [x] YSD-7039 Provide a clean Watch mode that hides study diagnostics while preserving authorized playback and the ability to return to prior state. - [x] YSD-7040 Provide no-AI manual mode and enumerate unavailable automated capabilities without fabricated substitute results. - [x] YSD-7041 Add beginner explanations, glossary links, guided prompts, and expert parameters through progressive disclosure. - [x] YSD-7042 Add visual regression, state restoration, large-project, permission-change, and reduced-motion tests for the complete layout. ### 7.3 Shared selection and cross-view interactions - [x] YSD-7060 Let users pin a work, moment, frame, image, region, sound interval, transcript span, runtime event, document passage, or authorized asset component without losing source identity or rights state. - [x] YSD-7061 Let users pin any moment into a compare tray without navigating away or resetting playback/lens context. - [x] YSD-7062 Provide create, accept, reject, correct, contest, merge where authorized, and keep-distinct actions for suggested cross-references. - [x] YSD-7063 Show relation type, endpoints, direction, rationale, author/model, confidence, anchors, context, rights, review, and limitations before acceptance. - [x] YSD-7064 Use restrained shared-selection transitions between source, compare, and inspiration views and disable or simplify them for reduced motion. - [x] YSD-7065 Expand graph neighborhoods only on request and bound the number of fetched/laid-out nodes. - [x] YSD-7066 Briefly highlight the active source-to-decision evidence path across coordinated views without relying on color or animation alone. - [x] YSD-7067 Provide undo/redo for draft view and annotation actions while retaining auditable version history for accepted records. - [x] YSD-7068 Add autosave, optimistic/pessimistic conflict feedback according to the approved collaboration model, and explicit offline queue state. - [x] YSD-7069 Add keyboard commands and screen-reader announcements for every selection, pin, relation, traversal, overlay, and undo/redo operation. - [x] YSD-7070 Add end-to-end tests proving canvas proximity does not create relationships and lookalike objects are never silently merged. ### 7.4 First-viewing and re-watch states - [x] YSD-7080 Implement a spoiler-safe first-viewing state that hides future hierarchy, annotations, beat labels, community/model claims, and navigation beyond the current playhead. - [x] YSD-7081 Record naive observations and reactions with explicit first- viewing context, source version, playhead state, and disclosure state. - [x] YSD-7082 Prevent hidden spoilers from leaking through search snippets, counts, graph neighbors, notebook embeds, keyboard labels, live presence, notifications, or assistive summaries. - [x] YSD-7083 Let learners opt in to reveal or mark completion of the source and record that transition without relabeling earlier observations. - [x] YSD-7084 Implement declared re-watch passes with focus such as structure, camera, performance, sound, edit, costume, animation, or mechanics. - [x] YSD-7085 Compare naive impressions with informed readings while keeping chronology and epistemic context intact. - [x] YSD-7086 Let teachers assign blind first passes and release annotated study sets only under configured completion/reveal rules. - [x] YSD-7087 Add adversarial spoiler-leakage and accessibility tests across all coordinated views and notifications. --- ## 8. Playback, navigation, annotation, and collaboration ### 8.1 Professional playback - [x] YSD-8001 Implement frame-accurate forward/backward stepping against the exact edition time base and surface variable-frame-rate limitations. - [x] YSD-8002 Implement jog/shuttle, variable speed, reverse, pause, seek, scrubbing preview, loop ranges, and frame/word/event stepping. - [x] YSD-8003 Implement A/B switching, split view, onion skin, synchronized skeleton/region overlays, and time warping where the source type permits. - [x] YSD-8004 Implement safe audio behavior for rate changes, reverse, short loops, channel selection, loudness, mute, solo, and assistive playback. - [x] YSD-8005 Display source timecode, rational frame rate, drop-frame state, proxy/source relation, current edition/build, and synchronization uncertainty. - [x] YSD-8006 Preserve accurate anchor creation while playing proxies and map selections back to the authoritative source time base. - [x] YSD-8007 Implement keyboard-first professional controls with remapping, conflict detection, command help, switch-access feasibility, and one-handed alternatives. - [x] YSD-8008 Meet buffered local frame-step, progress, timeline, and render performance budgets on the supported desktop baseline and accessible fallback. - [x] YSD-8009 Add decoder, rate, seek, VFR, drop-frame, multi-track, provider, reverse, loop, and proxy-to-source accuracy tests. ### 8.2 Hierarchy and timeline navigation - [x] YSD-8020 Render film, game, image, document, storyboard, 3D asset, and scene hierarchies with medium-appropriate terminology. - [x] YSD-8021 Support manual create, split, merge, reparent, reorder, relabel, resize, and delete-draft operations with versioned accepted corrections. - [x] YSD-8022 Show human/model source, segmentation version, confidence, disagreement, gaps, and accepted/corrected state for structural units. - [x] YSD-8023 Support overlapping, nested, recurring, discontinuous, and linked-moment annotations rather than assuming a single partition. - [x] YSD-8024 Implement timeline virtualization, progressive detail, snapping, range selection, pan/zoom, track filtering/grouping, density presets, and large-session performance. - [x] YSD-8025 Keep timeline labels, selections, focus, scroll, zoom, and playhead synchronized with source navigator, canvas, transcript, and evidence inspector. - [x] YSD-8026 Add accessible list/table alternatives for temporal navigation and editing with equivalent semantics. - [x] YSD-8027 Add correction diff, concurrent edit, long source, dense track, RTL label, keyboard, screen-reader, and performance tests. ### 8.3 Region, entity, and temporal annotation - [x] YSD-8040 Implement bounding box, polygon, mask, point, skeleton, tracked region, document region, waveform interval, runtime event, and 3D component annotation tools. - [x] YSD-8041 Support instant, frame, time range, beat, recurring motif, discontinuous interval, linked moment, and entity/property scopes. - [x] YSD-8042 Require annotation kind, epistemic type, anchors, author, source/edition, rights state, visibility, review state, and version. - [x] YSD-8043 Support lens-specific templates, prompts, required fields, controlled vocabulary, free text, uncertainty, limitations, and rubric hints. - [x] YSD-8044 Implement observation-first authoring and explicit promotion to interpretation or craft hypothesis with required evidence and context. - [x] YSD-8045 Support accepting, correcting, contesting, rejecting, and superseding machine suggestions without mutating the original detection. - [x] YSD-8046 Support entity linking, candidate identity, keep-distinct, cross-scene continuity, and uncertainty without biometric matching. - [x] YSD-8047 Generate permitted thumbnails/crops/overlays and useful textual descriptions for annotations under rights and accessibility policy. - [x] YSD-8048 Implement bulk annotation and import with per-record validation, partial failure, provenance, undo where safe, and audit. - [x] YSD-8049 Add geometry, time-base, version, concurrent-correction, keyboard, screen-reader, rights-change, and deletion tests. ### 8.4 Layered notes, review, and collaboration - [x] YSD-8060 Implement layered note types observation, interpretation, hypothesis, question, correction, counterreading, and limitation. - [x] YSD-8061 Implement comments, threaded replies, mentions, assignments, due state, resolution, review request, approval, and immutable conflict history. - [x] YSD-8062 Distinguish private draft, project, class/team, institution, published, and link-shared visibility with rights/consent checks. - [x] YSD-8063 Apply the approved CRDT/lock/lease strategy to annotation and note edits with offline reconciliation and understandable conflict UI. - [x] YSD-8064 Implement presence without exposing private source names, playheads, selections, or learner content to unauthorized participants. - [x] YSD-8065 Implement synchronized live co-study playback with host/ participant controls, latency/drift reporting, reconnect, and independent accessibility settings. - [x] YSD-8066 Implement anchored live discussion and crystallization into a reviewed claim that preserves participant authorship, dissent, source anchors, and consent. - [x] YSD-8067 Add moderation, removal, report, block, audit, session expiry, and retention controls for live and asynchronous collaboration. - [x] YSD-8068 Add concurrent editing, offline conflict, reconnect, role change, source expiry mid-session, moderation, and claim-crystallization tests. --- ## 9. Domain lens framework and craft analysis ### 9.1 Lens framework shared requirements - [x] YSD-9001 Define a versioned LensDefinition contract with accountable owner, supported source/tier, input tracks, output epistemic types, taxonomy versions, required rights, cost class, limitations, safety notes, renderer, correction actions, and evaluation suite. - [x] YSD-9002 Build a lens registry and capability endpoint that refuses unknown, disabled, unavailable, policy-incompatible, or unsupported lens/ source combinations. - [x] YSD-9003 Build reusable lens UI for selection, parameters, progress, tracks, overlays, evidence, terms, confidence, limitations, review, and version comparison. - [x] YSD-9004 Require lens outputs to bind to stable anchors and record analyzer/model/code/configuration, source revision, taxonomy, rights, confidence, and review state. - [x] YSD-9005 Keep detected features separate from human observations, interpretations, hypotheses, creator statements, and practice results in every lens. - [x] YSD-9006 Support manual-only lens templates with no model dependency and explicit unavailable automation. - [x] YSD-9007 Support cross-lens composition only through evidence-bearing outputs; preserve every upstream policy/version dependency. - [x] YSD-9008 Add review/correction interfaces for boundaries, regions, tracks, terms, measurements, relationships, and interpretations. - [x] YSD-9009 Add domain-expert gold sets, slice metrics, calibration, disagreement handling, known-limit documentation, and regression gates per lens. - [x] YSD-9010 Add performance budgets and graceful degradation so dense overlays never make source playback or manual annotation unusable. - [x] YSD-9011 Add keyboard, screen-reader, non-color, reduced-motion, textual summary, and structured-table alternatives per lens visualization. - [x] YSD-9012 Add lens-level rights, privacy, sensitive-feature, cultural, prompt-injection, export, and deletion tests. ### 9.2 Character and visual-design lens - [x] YSD-9030 Model character identity and role across scenes, editions, builds, states, disguises, costumes, skins, and transformations without appearance-only identity merges. - [x] YSD-9031 Support anchored manual and machine-suggested analysis of silhouette, shape language, proportion, scale, line, mass, negative space, and asymmetry. - [x] YSD-9032 Support anchored analysis of face, hair, makeup, scars, body marks, age-signaling design choices, and expression range without demographic inference. - [x] YSD-9033 Implement palette extraction and review for color script, contrast, saturation, value grouping, dominant/accent relations, and palette evolution across scenes/states. - [x] YSD-9034 Support material, surface, texture, wear, damage, repair, cleanliness, and environmental-storytelling observations. - [x] YSD-9035 Integrate Aglaea terms for costume layering, construction, fit, drape, fabric, fastening, footwear, jewelry, weapon carry, and accessories. - [x] YSD-9036 Link historical, occupational, cultural, status, faction, and ritual context to sourced terminology with applicability limitations and counterreadings. - [x] YSD-9037 Support prop relationships, repeated motifs, symbolic interpretations, and story-function hypotheses without presenting symbolism as source fact. - [x] YSD-9038 Build a character-turnaround view from rights-permitted frames only, show missing angles/uncertainty, and prohibit hallucinated views. - [x] YSD-9039 Track visual continuity and transformation across scenes, costumes, states, damage/wear, editions, and revisions. - [x] YSD-9040 Generate character system maps and original design briefs that extract principles and do-not-copy constraints rather than protected design details. - [x] YSD-9041 Add evaluation for region accuracy, palette fidelity, terminology, continuity, identity keep-distinct, culture/context, rights, and accessible comparison. ### 9.3 Cinematography and camera lens - [x] YSD-9060 Detect or annotate shot boundary, scale, angle, height, roll, orientation, movement, and stabilization with exact anchors and correction. - [x] YSD-9061 Estimate focal-length class and field of view only with explicit uncertainty unless trusted camera metadata exists. - [x] YSD-9062 Analyze perspective, compression, depth cues, depth of field, focus target, rack focus, and lens artifacts with visible evidence. - [x] YSD-9063 Analyze balance, leading lines, headroom, look room, symmetry, layers, occlusion, frame-within-frame, and subject hierarchy. - [x] YSD-9064 Analyze blocking relative to camera, eyelines, screen direction, entrances/exits, and power geometry. - [x] YSD-9065 Analyze movement path, speed, acceleration, motivation, reveal, parallax, and subjective/objective camera stance without overclaiming intent. - [x] YSD-9066 Analyze exposure, contrast, key/fill/rim relations, color temperature, practicals, shadow design, and lighting transitions while preserving source color-management context. - [x] YSD-9067 Analyze camera-to-performance relationships, including framing that suppresses or amplifies gesture, as contextual interpretations. - [x] YSD-9068 Consume trusted virtual-camera/gameplay-camera state in instrumented mode and keep estimates distinct in video-only mode. - [x] YSD-9069 Add camera metadata versus estimate comparison and uncertainty calibration. - [x] YSD-9070 Add evaluation for shot/track accuracy, camera-classification calibration, color/display correctness, correction, cultural/contextual humility, and accessible overlays. ### 9.4 Performance and acting lens - [x] YSD-9090 Provide source-grounded fields for scene objective, obstacle, tactic, stakes, given circumstances, relationship, status, and beat changes as observations/interpretations rather than detected facts. - [x] YSD-9091 Support facial-action observations for gaze, blink, jaw, mouth, tension, release, and asymmetry without identity or mental-state inference. - [x] YSD-9092 Support posture, weight, grounding, gesture, self-contact, reach, retreat, stillness, spatial use, and blocking observations. - [x] YSD-9093 Integrate Euterpe-aligned voice features for pitch, range, contour, volume, pace, rhythm, pause, breath, articulation, resonance, and overlap. - [x] YSD-9094 Support dialogue phrasing, emphasis, interruption, listening, reaction, subtext, and silence with transcript/audio/video anchors. - [x] YSD-9095 Support blocking precision, camera awareness, ensemble interaction, chemistry interpretations, and physical continuity without opaque quality scoring. - [x] YSD-9096 Model onset, build, peak, suppression, leakage, recovery, and transition of interpreted affect with contextual facets and uncertainty. - [x] YSD-9097 Build comparative-take workflows that expose observations, differences, choices, dissent, and context instead of one aggregate performance score. - [x] YSD-9098 Enforce actor-safe, behavior-specific, playable notes free of identity claims, diagnosis, humiliation, and presumed real emotion. - [x] YSD-9099 Add private dailies/rehearsal consent, access, watermark, collaboration, retention, export, and deletion policy. - [x] YSD-9100 Add evaluation across languages, cultures, acting traditions, camera conditions, disability presentations, voice/body variation, stylization, and legitimate disagreement. ### 9.5 Animation and motion lens - [x] YSD-9120 Analyze pose, silhouette, center of mass, balance, support, weight shift, line of action, and joint trajectories with correctable pose/track evidence. - [x] YSD-9121 Analyze timing, spacing, arcs, anticipation, follow-through, overlap, drag, overshoot, settle, holds, and moving holds. - [x] YSD-9122 Analyze contact, impact, recoil, recovery, locomotion phase, foot plant, root motion, and slip with exact intervals and uncertainty. - [x] YSD-9123 Analyze facial animation, lip synchronization, eye darts, blinks, micro-movement, and dialogue timing without treating stylization as error. - [x] YSD-9124 Model stylization, exaggeration, pose economy, limited/full animation characteristics, and cadence with tradition/context metadata. - [x] YSD-9125 Build motion trails, onion skin, pose overlays, synchronized skeleton comparison, phase normalization, and time-warp controls. - [x] YSD-9126 Consume trusted game animation state, blends, montages/abilities, responsiveness, cancel windows, locks, IK, notifies, and contacts when instrumented. - [x] YSD-9127 Keep video-only animation inferences explicitly distinct from engine telemetry. - [x] YSD-9128 Add non-color, reduced-motion, textual trajectory, table, and static key-pose alternatives for motion visualizations. - [x] YSD-9129 Add evaluation for pose/track error, contacts, phase boundaries, slip, timing, stylized motion, occlusion, correction, and accessible use. ### 9.6 Narrative and character-function lens - [x] YSD-9150 Support fabula/syuzhet, act/sequence/scene structure, causality, revelation, setup/payoff, and dramatic-irony claims with evidence and interpretive status. - [x] YSD-9151 Support character want, need, belief, wound, tactic, decision, reversal, relationship, arc, and story-function analysis without presenting theory as source fact. - [x] YSD-9152 Support scene question, value shift, conflict, stakes, beats, turning point, climax, resolution, and unresolved pressure. - [x] YSD-9153 Support dialogue function, exposition load, subtext, motif, theme, symbol, genre convention, and tonal shift with disagreement and cultural/historical context. - [x] YSD-9154 Measure pacing through duration, information rate, event density, shot rhythm, performance rhythm, and game agency while retaining qualitative context. - [x] YSD-9155 Support branching narrative, quest state, systemic story, player-authored sequence, and counterfactual paths in game/project-aware modes. - [x] YSD-9156 Reuse Hathor domain taxonomies and MDA/narrative engines through adapters rather than copying them into Yemaya. - [x] YSD-9157 Require narrative, theme, causal, intent, and cultural outputs to show evidence, counterevidence, epistemic status, limits, and reviewer context. - [x] YSD-9158 Add evaluation for boundary accuracy where measurable, unsupported-claim rate, evidence completeness, disagreement coverage, cultural/contextual handling, and source-version reproducibility. ### 9.7 Editing and temporal-construction lens - [x] YSD-9180 Detect or annotate cut type, transition, duration, rhythm, continuity/discontinuity, match, ellipsis, montage, and temporal compression. - [x] YSD-9181 Analyze picture-sound relationships, J/L cuts, reaction timing, held shots, insert function, and point-of-view construction. - [x] YSD-9182 Build coverage maps showing master/close-up relationships, take use, continuity deviations, missing coverage, and editorial emphasis. - [x] YSD-9183 Compute shot-duration distributions and sequence rhythm with source/cut identity, uncertainty, exclusions, and qualitative context. - [x] YSD-9184 Build an alternative-assembly sandbox limited to creator-owned or explicitly permitted clips and prevent unauthorized rendered exports. - [x] YSD-9185 Preserve source-to-edit decision lineage and distinguish hypothetical assembly from the source work. - [x] YSD-9186 Add edit-boundary, timecode, J/L relation, coverage, source- permission, assembly, and export tests. ### 9.8 Sound, voice, and music lens - [x] YSD-9210 Analyze dialogue, production sound, ADR, ambience, effects, foley, score, silence, and mix hierarchy with reviewable intervals. - [x] YSD-9211 Analyze loudness, dynamic range, spectral balance, spatial placement, reverberation, masking, and transitions with calibrated technical measurements. - [x] YSD-9212 Analyze sound motif, leitmotif, instrumentation, harmony, rhythm, tempo, meter, texture, and thematic transformation with epistemic labels. - [x] YSD-9213 Support diegetic, non-diegetic, internal, acousmatic, subjective, and point-of-audition classifications as reviewable interpretations. - [x] YSD-9214 Align voice-performance features with transcript, face/body behavior, camera, edit, and narrative context. - [x] YSD-9215 Analyze game audio triggers, priority, repetition, variation, state transitions, feedback timing, and mix under load using telemetry where authorized. - [x] YSD-9216 Gate source separation by rights and reliability; label inferred stems, separation model/version, artifacts, confidence, and prohibited downstream uses. - [x] YSD-9217 Provide waveform/spectrogram alternatives as text, events, tables, captions, and keyboard-navigable intervals. - [x] YSD-9218 Add audio-event, transcript, music, voice, separation, cross-modal sync, privacy, culture/language, and accessible-use evaluations. ### 9.9 Art direction, environment, prop, VFX, and UI lens - [x] YSD-9240 Analyze environment layout, architecture, geography, scale, landmarks, affordances, navigation, and visual hierarchy. - [x] YSD-9241 Analyze production-design motifs, decoration, clutter, wear, class/status signals, world rules, and historical context with sourced claims. - [x] YSD-9242 Track prop identity, function, interaction, continuity, material response, and symbolic interpretation with separate epistemic types. - [x] YSD-9243 Analyze VFX layers, particles, compositing, integration, simulation character, readability, and timing using permitted evidence. - [x] YSD-9244 Analyze film titles and game UI typography, information hierarchy, motion, feedback, diegesis, accessibility, and state. - [x] YSD-9245 Compare spatial progression and environmental storytelling across sequences, levels, versions, and player routes. - [x] YSD-9246 Add environment/prop continuity, region, material, UI state, VFX timing, culture/context, and accessibility evaluations. ### 9.10 Game-design and systems lens - [x] YSD-9270 Model core loop, verbs, goals, rules, resources, constraints, feedback, risk, reward, failure, recovery, and progression with evidence from play. - [x] YSD-9271 Build MDA mappings that distinguish observed dynamics from assumed mechanics and documented design intent. - [x] YSD-9272 Analyze control mapping, input buffering, response latency, aim/movement behavior, camera coupling, and accessibility settings with tier-appropriate certainty. - [x] YSD-9273 Analyze combat readability, anticipation, telegraphing, hit confirmation, stun/recovery, spacing, tempo, and decision windows. - [x] YSD-9274 Analyze AI perception, state, tactic, coordination, difficulty, and counterplay only from trusted instrumentation or explicitly as video-only inference. - [x] YSD-9275 Analyze level flow, gating, critical/optional paths, encounter rhythm, checkpoints, landmarks, and spatial teaching. - [x] YSD-9276 Analyze tutorialization, affordances, signifiers, onboarding, hint timing, failure messaging, and mastery curve. - [x] YSD-9277 Analyze economy sources/sinks, prices, scarcity, rewards, inventory pressure, unlocks, and progression pacing. - [x] YSD-9278 Analyze social, multiplayer, live-service, fairness, retention, and community systems without endorsing manipulative patterns. - [x] YSD-9279 Analyze CPU/GPU frame time, input/display/network latency, memory, loading, streaming, and their perceived-design effect. - [x] YSD-9280 Add evaluation that proves each output respects Tier A/B/C knowledge boundaries and never labels visible inference as engine truth. ### 9.11 Still-image and concept-art study - [x] YSD-9300 Build high-resolution tiled image viewing with deep zoom, pan, rotation, pixel/normalized coordinate mapping, and source color profile. - [x] YSD-9301 Implement rectangular/polygonal/mask/point region annotation, palette inspection, alignment guides, cross-image alignment, and revision-aware anchors. - [x] YSD-9302 Support character sheet/turnaround comparisons by view, expression, costume, accessory, material, proportion, construction, and missing coverage. - [x] YSD-9303 Support whole-image and independent region relationships without inheriting links from containment or canvas position. - [x] YSD-9304 Add image-scale, coordinate, tile-permission, region, accessibility, large-canvas, color-management, and revision tests. ### 9.12 Script, document, and storyboard study - [x] YSD-9320 Parse scripts/screenplays into scene headings, action, dialogue, characters, transitions, page timing, motifs, relationships, and revisions while preserving original text/format. - [x] YSD-9321 Compare script revisions and surface additions, deletions, reorderings, line changes, metadata changes, and unresolved alignment. - [x] YSD-9322 Align script to storyboard to shot/take to final and make missing, combined, reordered, or transformed material explicit. - [x] YSD-9323 Analyze storyboard composition, staging, proposed lens, continuity, movement arrows, notes, and editorial rhythm as source- documented or interpreted appropriately. - [x] YSD-9324 Build page/panel/block/line/word/region navigation and annotation with searchable OCR, original text, translation, and accessibility semantics. - [x] YSD-9325 Add document parser security, revision, alignment, RTL, annotation, OCR confidence, spoiler, export, and accessibility tests. ### 9.13 Creator-owned 3D, material, scene, and level study - [x] YSD-9350 Build sandboxed 3D inspection for hierarchy, mesh/topology, silhouette by view, units/scale, pivots, UVs, materials, textures, rig, skin weights, morphs, sockets, LODs, collision, and animation clips, reusing Neith/Maya engine crates and Bellona DCC bridges through the YSD-0165 adapters rather than reimplementing them. - [x] YSD-9351 Build material/shader study for graph structure, texture channels, value ranges, physical parameters, layers/blends, variants, and rendering context. - [x] YSD-9352 Build scene/level study for hierarchy, spatial relationships, actors/components, lights, cameras, volumes, splines, affordances, gameplay references, optimization, and version history. - [x] YSD-9353 Implement non-destructive measurement, guide, section-plane, exploded, wireframe, normals, UV, weight, skeleton, collision, and material-channel views. - [x] YSD-9354 Link selections to source DCC/engine objects only for creator- owned or explicitly authorized assets and retain native IDs/version sidecars. - [x] YSD-9355 Keep published works frame/evidence-based and prohibit extracted commercial asset inspection. - [x] YSD-9356 Add large-asset, malformed-scene, parser sandbox, coordinate, native-ID, permission, version, overlay, accessibility, and performance tests. --- ## 10. Emotion and Performance Atlas ### 10.1 Atlas platform and templates - [x] YSD-10001 Model AtlasTemplate separately from an atlas collection, with subject, declared question types, facet schema, evidence channels, comparison protocol, practice suggestions, safety notes, owner, version, and applicability. - [x] YSD-10002 Ship anger-related performance as a contextual exemplar rather than a universal emotion-recognition ontology. - [x] YSD-10003 Let authorized educators/domain experts create, review, version, localize, deprecate, and migrate atlas templates. - [x] YSD-10004 Support non-emotional subjects such as entrances, reveals, betrayals, boss introductions, tutorial moments, hit reactions, and costume transformations without inheriting anger facets uncritically. - [x] YSD-10005 Require every template to define subject-specific cultural, privacy, identity, dignity, and interpretation limitations. - [x] YSD-10006 Let facets be human-applied, model-suggested, or imported and show the source, confidence, taxonomy, review state, and limitations. - [x] YSD-10007 Build template migration that preserves prior facet meaning, accepted reviews, search behavior, and frozen comparisons. ### 10.2 Anger atlas facets - [x] YSD-10020 Implement context facets for betrayal, injustice, humiliation, obstruction, grief, threat, protective response, status challenge, and extensible reviewed values. - [x] YSD-10021 Implement function facets for instrumental, expressive, defensive, coercive, boundary-setting, displaced, performative, and extensible reviewed values. - [x] YSD-10022 Implement regulation facets for unfiltered, escalating, restrained, masked, leaked, redirected, recovering, and extensible reviewed values. - [x] YSD-10023 Implement intensity/time facets for simmer, onset, build, eruption, plateau, collapse, aftermath, and bounded user-defined values. - [x] YSD-10024 Implement relationship facets for intimate, familial, peer, subordinate/superior, stranger, crowd, self-directed, and culturally contextual alternatives. - [x] YSD-10025 Implement evidence-channel facets for face, gaze, voice, breath, posture, gesture, movement, language, silence, spacing, and missing/ unavailable channels. - [x] YSD-10026 Implement performance-style facets for naturalistic, theatrical, melodramatic, comedic, stylized animation, mocap, game loop, and tradition-specific values with provenance. - [x] YSD-10027 Implement camera/edit facets for unbroken close-up, withheld reaction, handheld pursuit, wide tableau, rapid montage, and reviewed extensible forms. - [x] YSD-10028 Implement sound-context facets for silence, score pressure, distorted subjective sound, dense effects, vocal isolation, and reviewed extensible forms. - [x] YSD-10029 Implement cultural/production context facets for place, era, language, acting tradition, genre convention, production constraint, and explicit unknown state. ### 10.3 Evidence-channel alignment - [x] YSD-10040 Align visible face/gaze observations with body, gesture, posture, distance, blocking, voice, breath, pace, overlap, articulation, silence, language, tactic, and subtext. - [x] YSD-10041 Align narrative circumstances and relationship state with camera distance/movement/composition, lighting, edit rhythm, sound design, score, animation state, and gameplay state. - [x] YSD-10042 Display missing, occluded, unreliable, rights-restricted, or unavailable channels instead of inferring values. - [x] YSD-10043 Keep detected acoustic/visual signals, human behavior observations, emotion-related interpretations, and craft hypotheses in separate rows/tracks. - [x] YSD-10044 Show human confidence, model confidence, reviewer agreement, dissent, counterexamples, and cultural/contextual limits without an aggregate truth score. ### 10.4 Comparison workflow - [x] YSD-10060 Require a comparison question before corpus selection, such as how restrained anger remains legible without raised volume. - [x] YSD-10061 Restrict source selection and preview generation to rights- cleared examples and permitted collaborators/audience. - [x] YSD-10062 Support filters for context, function, regulation, intensity, time, relationship, genre, culture, medium, style, channel, synthetic status, review, and missing context. - [x] YSD-10063 Require examples and counterexamples, record inclusion/ exclusion reasons, and prevent famous-source recommendation loops. - [x] YSD-10064 Support normalization only by a declared relevant dimension: line start, emotional turn, contact, selected beat, or duration. - [x] YSD-10065 Hide community and model interpretations until the learner records blind observations when the protocol requests it. - [x] YSD-10066 Build synchronized comparison of channel use, context, camera, edit, sound, animation/game state, agreement, and dissent. - [x] YSD-10067 Require craft hypotheses to cite supporting/counterevidence, scope, limitations, cultural context, and causal humility. - [x] YSD-10068 Convert a hypothesis into an original exercise and capture multiple-viewer feedback on intended relationship and stakes. - [x] YSD-10069 Freeze an atlas comparison to exact source, facet taxonomy, analysis, review, and rights-policy versions. ### 10.5 Safety and dignity enforcement - [x] YSD-10080 Block inferences about a performer's real emotion, mental state, diagnosis, honesty, identity, or demographic attributes. - [x] YSD-10081 Block face/voice embedding use for identifying people and prohibit cross-source biometric identity lookup. - [x] YSD-10082 Prevent facial action units, voice features, poses, or game animations from being presented as proof of emotion. - [x] YSD-10083 Prohibit cultural-conformity scores and presumed universal expression templates. - [x] YSD-10084 Enforce private rehearsal/audition/classroom consent, authorization, audience, retention, watermark, and deletion policy. - [x] YSD-10085 Prohibit global actor ranking and opaque emotional-truth scores in APIs, UI, search, exports, evaluations, and analytics. - [x] YSD-10086 Provide and lint for behavior-specific phrasing such as an observable change after an interruption rather than a declaration of true fury. - [x] YSD-10087 Add adversarial safety evaluations across prompts, model outputs, facet imports, user labels, search queries, comparison synthesis, feedback, and exports. ### 10.6 Atlas practice outputs - [x] YSD-10100 Provide a re-performance exercise varying restrained, escalating, and redirected tactics with original text/context. - [x] YSD-10101 Provide an animation exercise varying affect onset and recovery timing without copying source motion. - [x] YSD-10102 Provide a camera exercise shooting the same original performance in close-up and wide framing to study legibility. - [x] YSD-10103 Provide an editing exercise recutting learner-owned reactions to test audience reading. - [x] YSD-10104 Provide a sound exercise redesigning the sound bed for learner- owned picture while holding picture constant. - [x] YSD-10105 Provide a writing exercise creating an original scene with the same dramatic function but different expression, relationship, and setting. - [x] YSD-10106 Link each attempt, feedback item, reflection, revision, and mastery update to the source-derived principle rather than a mandate to duplicate the reference. - [x] YSD-10107 Add educator, performer, cultural-reviewer, accessibility, and learner evaluation of atlas usefulness, dignity, safety, and transfer. --- ## 11. Film, production-material, and paratext workflows ### 11.1 Film source integrity - [x] YSD-11001 Require work, exact cut, frame rate, aspect ratio, language, subtitle/audio version, color/mastering where known, and source mode for every film record. - [x] YSD-11002 Display file, licensed stream, provider link-only, internal production asset, and unknown source modes with their distinct capabilities and rights. - [x] YSD-11003 Prevent analyses, anchors, notebooks, comparison items, and exports from silently crossing film cuts or mastering versions. - [x] YSD-11004 Implement edition alignment and explicit gap handling for theatrical/director/extended, regional, censored, language, remastered, regraded, rescored, and frame-rate-converted versions. - [x] YSD-11005 Add film identity and alignment evaluation across cuts, masters, subtitle/audio variants, variable frame rates, and provider availability. ### 11.2 Film automatic suggestions - [x] YSD-11020 Suggest chapters, sequences, scenes, shots, transitions, fades, and structural boundaries with review/correction. - [x] YSD-11021 Suggest speakers, transcript alignment, dialogue turns, words, subtitle spans, and sound events with confidence and gaps. - [x] YSD-11022 Suggest people, tracks, poses, regions, props, garments, and environments without automatic biometric identity. - [x] YSD-11023 Suggest camera movement, composition, color, lighting, motion, focus, and technical changes with uncertainty and source color context. - [x] YSD-11024 Suggest music cues, tempo, loudness, ambience, effects, silence, and mix changes with exact audio intervals. - [x] YSD-11025 Suggest narrative beats, performance turns, motifs, themes, and relationships only as high-interpretation review candidates with evidence and limitations. - [x] YSD-11026 Calibrate directly measurable shot/transcript tasks separately from contextual theme/emotion suggestions and prevent shared confidence semantics from obscuring the difference. - [x] YSD-11027 Add human correction, false-positive, false-negative, calibration, disagreement, source-boundary, and stale-run evaluations for every suggestion family. ### 11.3 Production-material mode - [x] YSD-11040 Create a separately permissioned production-material workspace for dailies, scripts, storyboards, EDL/XML/AAF markers, camera/sound reports, lens metadata, continuity notes, and take metadata. - [x] YSD-11041 Implement script-to-take alignment with version, slate/take, line/beat, missing material, confidence, and manual correction. - [x] YSD-11042 Build coverage and missing-beat maps across script, storyboard, setups, takes, selects, and edit. - [x] YSD-11043 Build performance continuity and alternate-take comparison with private access, behavior-specific notes, approvals, and version history. - [x] YSD-11044 Compare camera/lens intent, reports, recorded metadata, and visual estimates without overwriting authoritative production metadata. - [x] YSD-11045 Track edit-decision lineage through source clips, takes, markers, versions, approvals, and turnovers. - [x] YSD-11046 Support VFX and sound turnover markers with owners, due state, source anchor, destination reference, status, and revision. - [x] YSD-11047 Implement review/approval workflows for dailies and production artifacts with watermark, download controls, comments, decisions, notifications, and audit. - [x] YSD-11048 Add interchange round-trip tests for every approved NLE, camera-report, sound-report, script, storyboard, and turnover format. - [x] YSD-11049 Add privacy, consent, role, watermark, expiry, lost-access, export, and deletion tests separate from published-work study. ### 11.4 Commentary, paratext, and creator statements - [x] YSD-11060 Align director/actor/editor/composer commentary to the exact edition and moment it discusses with method, confidence, drift, and review. - [x] YSD-11061 Link interviews, making-of documentaries, conference talks, GDC sessions, art books, patch notes, and developer diaries to works, scenes, mechanics, entities, and claims. - [x] YSD-11062 Store creator statements as creator-statement evidence with normal provenance, citation, rights, quote limits, authorship, and versioning. - [x] YSD-11063 Display creator statement and textual/craft analysis side by side without allowing the statement to settle an interpretation automatically. - [x] YSD-11064 Preserve contradiction between creator statements and between a statement and observable evidence with reviewer context. - [x] YSD-11065 Enforce paratext-specific attribution, permitted quotation, playback, transcript, embedding, teaching, publication, and export rules. - [x] YSD-11066 Add alignment, contradiction, quote-limit, citation, source- version, rights, accessibility, and export tests for paratexts. --- ## 12. Video-only, instrumented, and project-aware game study ### 12.1 Honest tiering and capability boundaries - [x] YSD-12001 Model Tier A video-only, Tier B instrumented session, and Tier C creator-owned project-aware analysis as explicit source capabilities. - [x] YSD-12002 In Tier A, permit visual/audio/UI/apparent-action/timing/level- flow/manual-mechanic study and prohibit hidden-state or exact-input claims. - [x] YSD-12003 In Tier B, accept signed video plus input/state/camera/ animation/AI/combat/economy/network/performance telemetry from an authorized build. - [x] YSD-12004 In Tier C, add authorized asset, level, animation graph, behavior tree, data table, source-project, and version links. - [x] YSD-12005 Prevent UI, API, search, notebooks, reports, synthesis, and comparisons from rendering Tier A inference as Tier B/C engine truth. - [x] YSD-12006 Display unavailable hidden-state fields, capture gaps, clock uncertainty, and source-tier limitations at the point of use. - [x] YSD-12007 Add tier-transition behavior when an authorized connector is attached later without rewriting prior video-only records. - [x] YSD-12008 Add adversarial boundary tests for inferred inputs, AI state, damage, hitboxes, economy, animation state, and project assets. ### 12.2 Instrumented session SDK and synchronization - [x] YSD-12020 Define and publish a versioned engine-neutral session envelope, event schema registry, signed manifest, connector capability handshake, and compatibility policy. - [x] YSD-12021 Implement monotonic session clock, video clock, engine frame, event timestamp, and mapping records with drift/error estimation. - [x] YSD-12022 Capture build, patch, platform, region, content manifest, settings, device, controller, accessibility assists, mods, and network metadata. - [x] YSD-12023 Classify deterministic replay, best-effort replay, recorded state, telemetry-only, and non-reproducible capture honestly. - [x] YSD-12024 Version every event schema and preserve accountable source ownership, producer build, clock, sequence, and privacy class. - [x] YSD-12025 Filter or pseudonymize player identifiers, chat, voice, account, network, and sensitive telemetry before durable ingest. - [x] YSD-12026 Detect and surface dropped frames/events, clock discontinuity, out-of-order events, duplicates, missing tracks, and connector degradation. - [x] YSD-12027 Build Unreal, Unity, Godot, V2, and future product adapters only behind the shared envelope and capability negotiation, reusing Bellona's engine-bridge libraries where they already cover the target engine. - [x] YSD-12028 Add SDK conformance fixtures, sample integration, upgrade guide, backwards-compatibility tests, clock-drift tests, and privacy tests. - [x] YSD-12029 Validate one owned title end to end with reproducible session, replay/bookmark restoration, exact build, settings, checkpoint, and event range. ### 12.3 Instrumented event families - [x] YSD-12040 Implement input events for device, action, press/release, analog value, buffering, remapping, accessibility assists, sequence, and timestamp. - [x] YSD-12041 Implement player-state events for transform, velocity, locomotion, health, resources, status, inventory, target, and ability state. - [x] YSD-12042 Implement camera events for mode, transform, target, obstruction, assist, shake, FOV, transition, and configuration. - [x] YSD-12043 Implement animation events for state, montage, clip, normalized time, blend, root motion, notifies, IK, contact, lock, and cancellation. - [x] YSD-12044 Implement combat events for attack phase, hitbox/hurtbox, collision, damage, stun, invulnerability, cancel, parry, hit confirmation, and source entity. - [x] YSD-12045 Implement AI events for perception, threat, state, goal, selected action, path, coordination, difficulty modifier, and authorized explainability limits. - [x] YSD-12046 Implement level events for checkpoint, volume, encounter, streaming, objective, landmark, route, fail/retry, and world revision. - [x] YSD-12047 Implement narrative events for quest, dialogue, choice, flag, relationship, branch, consequence, and systemic story event. - [x] YSD-12048 Implement economy events for source, sink, balance, purchase, reward, unlock, scarcity, inventory, and progression. - [x] YSD-12049 Implement UI/audio/feedback events for prompt, icon, haptic, sound, music state, subtitle, accessibility feedback, and priority. - [x] YSD-12050 Implement technical events for CPU/GPU frame time, input/ display/network latency, memory, streaming, load, error, and dropped samples. - [x] YSD-12051 Add schema validation, ordering, deduplication, sampling, clock-mapping, gap, privacy, load, and cross-version tests per event family. ### 12.4 Video-only analysis assists - [x] YSD-12070 Implement rights-permitted HUD OCR/template detection for health, resource, ammunition, cooldown, score, damage number, and objective text. - [x] YSD-12071 Bind every HUD value to the exact visible frames, OCR/template model/version, confidence, review state, and video-only detection label. - [x] YSD-12072 Implement input-overlay recognition only when the footage visibly includes a capture/community overlay. - [x] YSD-12073 Represent occluded, ambiguous, dropped, or missing input- overlay indicators and prohibit reconstruction of hidden inputs as fact. - [x] YSD-12074 Import community frame-data tables, patch notes, mechanics wikis, and speedrun data as separately cited source-documented facts with version and authorship. - [x] YSD-12075 Keep imported community facts, visual measurements, manual annotations, and instrumented telemetry in distinct query fields and UI rows. - [x] YSD-12076 Add accuracy/calibration tests across HUD styles, resolutions, compression, accessibility modes, occlusion, language, patch changes, and explicit no-hidden-state assertions. ### 12.5 Game study outputs - [x] YSD-12090 Build input-to-response latency maps with clock error, sampling limits, display/capture latency distinction, and Tier label. - [x] YSD-12091 Build mechanic state diagrams and evidence-linked transition tables with observed, documented, inferred, and unknown distinctions. - [x] YSD-12092 Build encounter and difficulty curves with player/session context, settings, patch, cohort privacy, and uncertainty. - [x] YSD-12093 Build tutorial teaching sequences and failure/recovery maps with observed player actions, system feedback, and counterexamples. - [x] YSD-12094 Build combat-readability and decision-window timelines aligned to telegraph, input, animation, hit, feedback, and recovery. - [x] YSD-12095 Build camera/animation/control coupling analyses with video, input, camera, animation, and latency tracks. - [x] YSD-12096 Build level route, attention, landmark, pacing, critical/ optional path, checkpoint, and encounter maps. - [x] YSD-12097 Build economy source/sink, balance, scarcity, unlock, purchase, reward, and progression graphs. - [x] YSD-12098 Build privacy-thresholded player-behavior heatmaps that suppress small cohorts and unauthorized identifiers. - [x] YSD-12099 Build a hit-feel micro-timeline aligning hitstop, camera shake, particles, layered sound, haptics/rumble, UI feedback, damage, and recovery for one action. - [x] YSD-12100 Build reproducible session bookmarks containing exact build, content manifest, save/checkpoint, settings, device, network, source tracks, event range, and replay classification. - [x] YSD-12101 Build encounter comparison that restores sessions or explicitly reports non-reproducibility and changed/missing build content. - [x] YSD-12102 Add domain-expert and player evaluation for correctness, usefulness, tier honesty, privacy, accessibility, performance, and reproducibility of every output. ### 12.6 External-title enforcement - [x] YSD-12120 Keep games not owned or controlled in video-only mode unless an authorized publisher/platform data interface is verified. - [x] YSD-12121 Reject connectors or plugins that inject into processes, evade anti-cheat, scrape memory, decrypt archives, extract protected assets, or bypass platform controls. - [x] YSD-12122 Display the source of authority and connector capability in every instrumented/session view. - [x] YSD-12123 Add security and policy tests with malicious connector manifests, unsigned events, spoofed builds, memory-scraping claims, protected assets, and revoked publisher authority. --- ## 13. Search, comparison, inspiration, graph discovery, and synthesis ### 13.1 Hybrid search foundation - [x] YSD-13001 Define a typed query AST that expresses source, locator, epistemic, taxonomy, text, vector, runtime, relationship, rights, permission, synthetic-media, culture, language, review, and version filters. - [x] YSD-13002 Parse natural-language queries into the typed AST with an inspectable plan; require confirmation for materially ambiguous or broadened interpretations. - [x] YSD-13003 Execute exact metadata search over work, edition/build, creator, performer, character, level, date, genre, language, platform, and source version. - [x] YSD-13004 Execute taxonomy search over shot type, motion principle, garment, narrative function, mechanic, sound event, performance facet, and domain extensions. - [x] YSD-13005 Execute full-text search over transcripts, subtitles, notes, documents, comments, claims, creator statements, questions, and original project records. - [x] YSD-13006 Execute semantic search over policy-permitted descriptions and embeddings with source/model/version and explanation. - [x] YSD-13007 Execute visual search by user-selected palette, composition, silhouette, pose, object, whole image, or region dimensions. - [x] YSD-13008 Execute motion search by pose sequence, trajectory, timing, contact, phase, or action dimensions. - [x] YSD-13009 Execute audio search by voice feature, rhythm, timbre, music, sound event, or mix dimensions without biometric identity. - [x] YSD-13010 Execute runtime search by event sequence, state transition, mechanic, input pattern, settings, or performance condition. - [x] YSD-13011 Execute relational search across entity relations, motifs, claims/evidence, regions/principles, principles/concepts, decisions/ outputs, and source-to-decision paths. - [x] YSD-13012 Allow explicit filtering by detected, observed, interpreted, source-documented, creator-statement, and practice-result values. - [x] YSD-13013 Return source anchors, context, confidence, dissent, counterevidence, rights-permitted previews, explanation, review, version, and missing data with each result. - [x] YSD-13014 Support group-by and facet behavior for medium, genre, era, culture, language, tradition, synthetic status, source class, epistemic type, and user-selected fields. - [x] YSD-13015 Prevent rights leakage through result existence, count, facet, timing, ordering, snippet, vector distance, related query, cluster, or cache key. - [x] YSD-13016 Add query planner limits, cancellation, timeout, cost estimate, pagination, stable ranking, reproducibility snapshot, and audit. - [x] YSD-13017 Meet ordinary and cross-modal first-useful-page performance budgets on representative corpora. - [x] YSD-13018 Build versioned relevance, diversity, calibration, permission, cultural, language, latency, and no-result evaluation sets. ### 13.2 Comparison-set authoring and alignment - [x] YSD-13030 Require a declared research question, corpus boundary, inclusion criteria, exclusions, examples, counterexamples, and rights state for every ComparisonSet. - [x] YSD-13031 Support manual selection, search-to-set, atlas-to-set, notebook-to-set, and graph-to-set workflows without losing anchors. - [x] YSD-13032 Align examples by absolute time/frame with exact time-base and edition identity. - [x] YSD-13033 Align examples by normalized clip duration with explicit information loss. - [x] YSD-13034 Align examples by selected beat, dialogue line, word, performance turn, or manually marked semantic event. - [x] YSD-13035 Align examples by motion event such as anticipation, contact, impact, recoil, settle, or recovery. - [x] YSD-13036 Align examples by narrative event such as reveal, reversal, decision, entrance, or payoff. - [x] YSD-13037 Align examples by gameplay event such as input, telegraph, hit, failure, recovery, checkpoint, or reward. - [x] YSD-13038 Support manually placed, named, ordered sync markers with per-example offsets and correction. - [x] YSD-13039 Record alignment method, parameters, confidence, uncertainty, author/analyzer, source versions, and accepted corrections. - [x] YSD-13040 Freeze comparison snapshots against exact sources, rights, alignments, annotations, taxonomies, analysis runs, and layout. - [x] YSD-13041 Add alignment accuracy, drift, version-change, missing-event, counterexample, permission, restore, and accessibility tests. ### 13.3 Focused synchronized comparison - [x] YSD-13060 Support two-to-eight-up playback by start, event, beat, pose, line, normalized duration, or manual markers. - [x] YSD-13061 Provide master and independent playheads, loop, speed, audio solo/mix, offset, frame step, and resynchronization controls. - [x] YSD-13062 Show alignment uncertainty and prevent a visually aligned grid from implying identical causal or medium semantics. - [x] YSD-13063 Build rights-aware difference overlays for pose, motion, palette, framing, loudness, timing, and runtime state. - [x] YSD-13064 Build contact sheets, strip views, beat boards, shot maps, relationship maps, state graphs, and motif timelines from the same ComparisonSet. - [x] YSD-13065 Keep examples, counterexamples, unknowns, dissent, and missing channels visible rather than filling gaps with guesses. - [x] YSD-13066 Add keyboard, screen-reader, captions, transcript, non-color, reduced-motion, audio-focus, and zoom alternatives. - [x] YSD-13067 Add two/eight-source load, drift, buffering, mixed frame-rate, permission-change, hidden spoiler, and assistive-technology tests. ### 13.4 Cross-work and cross-media matrix - [x] YSD-13080 Support a comparison corpus larger than eight while keeping simultaneous synchronized playback capped at two-to-eight. - [x] YSD-13081 Let rows/columns represent works, scenes, frames, regions, entities, examples, original concepts, or user-selected craft dimensions. - [x] YSD-13082 Implement multi-key sort, group, facet, filter, cluster, annotation, pin, saved template, and column configuration. - [x] YSD-13083 Represent observed values, interpretations, unknowns, disagreement, counterexamples, and unavailable/forbidden values distinctly. - [x] YSD-13084 Support within-medium alignment and explicitly labeled cross-media functional analogy without claiming identical mechanics. - [x] YSD-13085 Roll up from region to image, scene, work, collection, and corpus while retaining counts, exceptions, and underlying anchors. - [x] YSD-13086 Drill from aggregate patterns to every supporting, contradicting, excluded, or missing example. - [x] YSD-13087 Virtualize large matrices and meet filtering, sorting, resize, keyboard navigation, screen-reader table, and 10,000-item performance budgets. - [x] YSD-13088 Add sparse-data, mixed-epistemic, permission, roll-up/drill- down, cross-media labeling, saved-view, export, and accessibility tests. ### 13.5 Inspiration collection and item workflows - [x] YSD-13100 Require each collection to declare a creative question/intent, target project/concepts, intended audience effect, scope, exclusions, and collaborators. - [x] YSD-13101 Let an item address a whole work, edition, scene, frame, image, region, object, pose, palette, sound interval, transcript span, runtime event, document passage, or authorized asset component. - [x] YSD-13102 Require exact anchor and permitted preview, selection rationale, relevant aspect, intended experience/problem, abstract principle or open question, and do-not-copy boundary. - [x] YSD-13103 Require item role support, contrast, counterexample, boundary, precedent, warning, unresolved possibility, or reviewed extension. - [x] YSD-13104 Preserve rights, attribution, culture/context, confidence, authorship, review state, source/analysis version, and expiry impact. - [x] YSD-13105 Support multi-level linking so an image whole and its regions can participate independently in characters, materials, motifs, palettes, locations, principles, and concepts. - [x] YSD-13106 Implement bulk pin/import with deduplication suggestions, quarantine, per-item rights review, and no automatic relationship from board proximity. - [x] YSD-13107 Coordinate dominant media canvas, contact sheet, matrix, graph, timeline, and notebook outline as views over one authoritative item/edge model. - [x] YSD-13108 Preserve canvas position, grouping, scale, labels, and view state as presentation metadata with versioning and collaboration. - [x] YSD-13109 Add project/source/rights/version change impact, broken preview, missing source, and decision-dependency indicators. - [x] YSD-13110 Add end-to-end tests for multi-work whole-image and region pin, do-not-copy note, manual typed edge, reload, permission loss, expiry, and accessible non-spatial use. ### 13.6 Relationship graph behavior - [x] YSD-13130 Build manual typed-edge creation with endpoint search, direction, relation, rationale, evidence, counterevidence, context, limitation, and review. - [x] YSD-13131 Build explainable machine suggestions for similarity, difference, analogy, contrast, identity candidate, shared function, coverage gap, and bridge relation. - [x] YSD-13132 Display contributing features/relationships, model/version, confidence, missing evidence, rights eligibility, and potential cultural/ contextual limits for every suggestion. - [x] YSD-13133 Implement accept, reject, correct, contest, merge where authorized, and keep-distinct with immutable review history. - [x] YSD-13134 Build bidirectional backlinks and path inspection from either endpoint with every supporting anchor and permission decision. - [x] YSD-13135 Build bounded neighborhood expansion, filtered traversal, grouping, clustering, layout presets, saved views, and progressive disclosure. - [x] YSD-13136 Answer dependency queries such as all source regions informing a faction rule and all decisions depending on an expiring source. - [x] YSD-13137 Apply permission filters on every traversal step and suppress unauthorized node/edge existence, counts, previews, and path shape. - [x] YSD-13138 Keep source-derived and original-project graph namespaces distinct while permitting explicit principle-mediated relations. - [x] YSD-13139 Support validity intervals and open impact review when source, claim, principle, concept, decision, rights, or endpoint version changes. - [x] YSD-13140 Meet the 5,000-node filtered progressive-view budget without attempting an unreadable full layout. - [x] YSD-13141 Provide list, outline, structured-table, path-step, search, and keyboard alternatives for all graph actions. - [x] YSD-13142 Add relation-precision, keep-distinct, explanation, graph- integrity, path, permission, change-impact, accessibility, and performance evaluations. ### 13.7 Similarity, difference, and discovery - [x] YSD-13160 Implement More like this with user-selected palette, composition, shape, motion, sound, mechanic, tone, or narrative-function dimensions. - [x] YSD-13161 Implement Functionally analogous across medium, genre, culture, period, and technique with explicit analogy rationale and non-equivalence. - [x] YSD-13162 Implement Productive contrast and Show me something unlike these with controllable dimensions and distance. - [x] YSD-13163 Implement bridge references that expose a reviewable path between otherwise distant clusters. - [x] YSD-13164 Implement coverage-gap discovery for missing views, cultures, eras, disciplines, counterexamples, and world-system dimensions. - [x] YSD-13165 Let users weight, exclude, lock, or broaden retrieval dimensions and set diversity, distance, culture, period, medium, source, and rights boundaries. - [x] YSD-13166 Explain why every result was retrieved, contributing features/ relations, evidence gaps, source concentration, rights eligibility, and review status. - [x] YSD-13167 Build recommender controls that prevent repeated concentration on one famous work, style, provider, close derivative, culture, era, or already selected cluster. - [x] YSD-13168 Preserve user rejection/keep-distinct feedback without creating hidden cultural or stylistic filter bubbles. - [x] YSD-13169 Evaluate same-function, productive-contrast, bridge, keep-distinct, diversity, cultural-context, famous-source concentration, explanation, permission, and creative-diversity impact. ### 13.8 Original film, game, and world concept systems - [x] YSD-13180 Build project-native concept types for premise, theme, tone, genre contract, audience experience, and dramatic questions. - [x] YSD-13181 Build concept types for characters, relationships, factions, cultures, institutions, language, belief, ritual, history, conflict, and power. - [x] YSD-13182 Build concept types for geography, architecture, environment, ecology, climate, resources, technology, material culture, costume, props, color, and visual rules. - [x] YSD-13183 Build concept types for sound worlds, music rules, voice, rhythm, silence, and sonic motifs. - [x] YSD-13184 Build game concept types for levels, quests, encounters, mechanics, controls, feedback, economy, progression, AI, camera, animation, UI, accessibility, and agency. - [x] YSD-13185 Build film concept types for structure, sequence/scene logic, performance rules, camera grammar, lighting, editing, VFX, and production constraints. - [x] YSD-13186 Support project-defined extensions without erasing ownership, schema versioning, accessibility semantics, or portable export. - [x] YSD-13187 Build coverage views across selected concept systems, declared scope, required dimensions, unknowns, and intentionally excluded areas. - [x] YSD-13188 Build consistency/contradiction views that open questions rather than declaring contradictions to be errors. - [x] YSD-13189 Report source concentration, overly direct mappings, unsupported assumptions, missing perspectives, and concepts without evidence or original rationale. - [x] YSD-13190 Require human-authored rationale, alternatives, transformation, intended effect, owner, and source/principle paths before committing a creative decision. - [x] YSD-13191 Add graph, coverage, contradiction, source-concentration, project-native identity, collaboration, accessibility, and version tests. ### 13.9 Generated synthesis - [x] YSD-13210 Bind every generated synthesis to an explicit, rights-filtered evidence set and retrieval/query snapshot. - [x] YSD-13211 Include conflicting evidence, dissent, counterexamples, corpus boundaries, missing context, excluded sources, and limitations. - [x] YSD-13212 Distinguish detected, observed, source-documented, interpreted, speculative, creator-statement, and outcome evidence in generated prose and structured output. - [x] YSD-13213 Soften causal language unless supported by appropriate evidence or an attributed creator statement, and never convert creator intent into textual truth. - [x] YSD-13214 Let users open every citation at the exact authorized anchor and report inaccessible/expired dependencies. - [x] YSD-13215 Let users freeze synthesis against exact source, analysis, taxonomy, policy, prompt/model, and review versions. - [x] YSD-13216 Make regeneration a new version with a diff; never overwrite the prior scholarly record. - [x] YSD-13217 Add unsupported-claim, citation-completeness, permission, disagreement, causal-language, stale-source, prompt-injection, and reproducibility evaluations. ### 13.10 Source-to-decision trace and impact - [x] YSD-13230 Implement a traversable chain from authorized source through exact anchor, observation/fact, interpretation/counterreading, principle, original concept, decision, production artifact, outcome, and track record. - [x] YSD-13231 Allow forward and reverse traversal with source/endpoint version, review, rights, confidence, limitations, and current validity at every step. - [x] YSD-13232 Allow explicitly unsupported original exploration as a decision origin without fabricating source evidence. - [x] YSD-13233 Detect source expiry, deletion, claim contest, analysis change, relation correction, concept revision, decision revision, production change, and outcome change. - [x] YSD-13234 Calculate every affected collection, comparison, notebook, exercise, concept, decision, export, task, and production artifact. - [x] YSD-13235 Open review tasks with affected evidence paths, reason, alternatives, owner, due state, and current access rather than silently rewriting accepted decisions. - [x] YSD-13236 Record review resolution as keep, revise, supersede, detach, replace source, or retire, with rationale and immutable history. - [x] YSD-13237 Add path-completeness, broken-edge, impact-accuracy, permission, cyclic-dependency, deletion, stale-export, and review-resolution tests. ### 13.11 Outcome evidence and principle track records - [x] YSD-13250 Capture playtest telemetry, screening feedback, review-session feedback, and release analytics under source-grade rights, privacy, consent, anchor, version, and retention rules. - [x] YSD-13251 Require each committed decision to state intended audience effect before outcome evidence is evaluated. - [x] YSD-13252 Compare outcome evidence to stated intent rather than a generic quality, taste, engagement, or commercial-success score. - [x] YSD-13253 Accumulate contextual principle track records containing use, project/context, intended effect, evidence, supported/contradicted/ unresolved result, and limitations. - [x] YSD-13254 Render track records as contextual summaries and examples, not rankings or automatic promotion/demotion of principles. - [x] YSD-13255 Keep outcome evidence in the practice-result epistemic family and prevent it from rewriting the original source-study record. - [x] YSD-13256 Open impact review on principles and decisions affected by new outcomes and preserve prior conclusions. - [x] YSD-13257 Add small-cohort privacy, consent, intended-effect, conflicting- outcome, context-transfer, update, deletion, and no-auto-score tests. --- ## 14. Learning, deliberate practice, retention, and teaching ### 14.1 Durable learning loop - [x] YSD-14001 Make StudyQuestion a first-class starting object for observe, deconstruct, compare, hypothesize, practice, feedback, mastery, and new question cycles. - [x] YSD-14002 Build open, under-investigation, answered, and abandoned lifecycle transitions with rationale, linked evidence, and history. - [x] YSD-14003 Link every observation, comparison, inspiration collection, claim, exercise, attempt, reflection, and decision spawned by a question. - [x] YSD-14004 Build project-level unanswered-question, stale-question, duplicate-question, blocked-question, and recently-answered views. - [x] YSD-14005 Let a learner fork an expert or shared question while preserving source attribution and creating independent project-owned work. - [x] YSD-14006 Add end-to-end tests for question creation through evidence, comparison, exercise, attempt, reflection, mastery evidence, and follow-up question. ### 14.2 Metis craft concept graph - [x] YSD-14020 Define a distinct pedagogical concept graph with concept owner, definition, prerequisites, related concepts, evidence types, rubric dimensions, exercises, taxonomy version, and cultural/applicability limits. - [x] YSD-14021 Seed prerequisites such as frame navigation before shot rhythm and observable behavior before performance interpretation. - [x] YSD-14022 Seed timing/spacing before complex animation polish and goal/rule/feedback before economy-balancing analysis. - [x] YSD-14023 Seed focal length/distance before perspective comparison and source observation before cultural/thematic interpretation. - [x] YSD-14024 Let domain experts revise prerequisites and represent alternate paths, co-requisites, non-linear growth, contested sequences, and learner-specific accommodations. - [x] YSD-14025 Keep the pedagogical concept graph distinct from the original- project concept graph and connect them only through explicit exercise or principle relations. - [x] YSD-14026 Model factual knowledge, perceptual discrimination, analysis quality, production application, reflection, and repeated performance as separate evidence dimensions. - [x] YSD-14027 Prohibit collapsing taste, originality, cultural conformity, or creative quality into one numeric mastery probability. - [x] YSD-14028 Add graph migration, alternate-path, circular-prerequisite, version, mastery-evidence, accessibility, and separation tests. ### 14.3 Exercise authoring and execution - [x] YSD-14040 Build exercise authoring with objective, bounded scope, constraints, concepts, source-safe examples/counterexamples, rubric, expected evidence, accommodations, estimated effort, and rights. - [x] YSD-14041 Implement identify-and-justify exercises for shot, beat, pose, mechanic, sound cue, garment, prop, camera choice, or story function. - [x] YSD-14042 Implement blind comparison exercises that conceal metadata, model/community interpretations, and answers until learner submission. - [x] YSD-14043 Implement sorting exercises by a declared observable dimension with counterexamples and ambiguity. - [x] YSD-14044 Implement boundary-marking exercises and comparison with expert/consensus annotations while preserving legitimate disagreement. - [x] YSD-14045 Implement reconstruction exercises for state graphs, shot maps, blocking diagrams, sound hierarchies, edit maps, or concept relations. - [x] YSD-14046 Implement original-creation exercises for scenes, animation, shots, costumes, levels, mechanics, sound beds, or concept systems under abstract constraints. - [x] YSD-14047 Implement diagnosis/revision exercises on learner-owned attempts with source-anchored feedback and version comparison. - [x] YSD-14048 Implement teach-back exercises requiring a principle, authorized source anchors, limitations, and a counterexample. - [x] YSD-14049 Implement portfolio reflection comparing early, revised, and later attempts with learner-controlled privacy. - [x] YSD-14050 Add assignment, due date, learner/teacher roles, accommodations, allowed collaboration, submission, resubmission, late/extension, and publication controls. - [x] YSD-14051 Add rights, spoiler, accessibility, evidence, originality, grading override, challenge, privacy, and deletion tests per exercise family. ### 14.4 Rubrics, assessment, and feedback - [x] YSD-14070 Define rubric criteria for anchor accuracy and source use. - [x] YSD-14071 Define rubric criteria for separating observation from interpretation and creator statement from inference. - [x] YSD-14072 Define rubric criteria for appropriate craft vocabulary and taxonomy/context awareness. - [x] YSD-14073 Define rubric criteria for uncertainty, limitation, cultural context, and causal humility. - [x] YSD-14074 Define rubric criteria for comparison quality, inclusion logic, dissent, and counterexample selection. - [x] YSD-14075 Define rubric criteria for original transfer, transformation from principles, and protected-expression avoidance. - [x] YSD-14076 Define rubric criteria for revision quality, reflection, and ability to explain decisions. - [x] YSD-14077 Show criteria, scale, examples, accommodations, assessor identity, model role, confidence, and appeal path before submission. - [x] YSD-14078 Require automated feedback to cite the learner's attempt/source anchor and be actionable, behavior-specific, contextual, and contestable. - [x] YSD-14079 Keep automated, teacher, mentor, peer, self, and imported feedback visually and semantically distinct. - [x] YSD-14080 Let teachers override automated/consensus assessment with a reason and immutable before/after history. - [x] YSD-14081 Let learners challenge a label, score, relation, or feedback item and route it to review without penalty by default. - [x] YSD-14082 Allow creative divergence to satisfy a principle through a different solution and prohibit reference imitation as the rubric default. - [x] YSD-14083 Add assessment calibration, assessor consistency where meaningful, disagreement coverage, cultural bias, accessibility, override, challenge, and no-opaque-score tests. ### 14.5 Attempts, reflection, mastery, and portfolio - [x] YSD-14100 Support learner-owned video, audio, image, document, storyboard, 3D, engine session, notebook, and production-artifact attempts under consent and rights policy. - [x] YSD-14101 Version attempts and preserve anchor continuity, feedback, reflection, revisions, assessor context, and deletion/export controls. - [x] YSD-14102 Compare attempts against principles and selected references without a mandate or automatic objective to duplicate them. - [x] YSD-14103 Build evidence-linked automated suggestions behind approved model, privacy, safety, rights, and local-processing policy. - [x] YSD-14104 Support human and peer feedback with role, visibility, moderation, assignment, resolution, and consent. - [x] YSD-14105 Require learner reflection on intent, observations, feedback accepted/rejected, revision decision, uncertainty, and next question. - [x] YSD-14106 Record mastery evidence through Metis by concept and dimension, with assessor/source/version and uncertainty. - [x] YSD-14107 Build versioned portfolios showing questions, studies, comparisons, attempts, feedback, decisions, revisions, and learner- selected narrative. - [x] YSD-14108 Let learners control portfolio audience and revoke publication or consent with downstream cleanup. - [x] YSD-14109 Add attempt upload, private processing, feedback, revision, mastery, portfolio, consent revocation, export, deletion, and accessibility tests. ### 14.6 First-viewing pedagogy - [x] YSD-14130 Let teachers create blind first-pass assignments with bounded source access and spoiler-safe release rules. - [x] YSD-14131 Capture naive learner observations separately from informed re-watch analysis and retain exact disclosure state. - [x] YSD-14132 Let teachers release expert annotation, peer claims, model suggestions, terminology, or structural map in stages. - [x] YSD-14133 Build reflection comparing the learner's first experience with later named craft understanding. - [x] YSD-14134 Prevent grading or analytics from penalizing a learner for observations made without later-revealed context. - [x] YSD-14135 Add spoiler-leak, staged-release, late-join, replay, screen- reader, export, and assignment-copy tests. ### 14.7 Spaced review and perceptual drills - [x] YSD-14150 Integrate Metis FSRS-family and item-response schedulers through versioned adapters rather than implementing a separate scheduler. - [x] YSD-14151 Generate review items from study cards, claims, vocabulary, questions, comparisons, and prior feedback with source backlinks. - [x] YSD-14152 Generate perceptual-discrimination drills only from rights- permitted derivatives and record source anchors plus intended distinction. - [x] YSD-14153 Support drills such as longer-lens discrimination, cutting on action, pose/contact phase, sound hierarchy, palette/value grouping, and visible game feedback. - [x] YSD-14154 Let learners open underlying evidence and contest the intended distinction or answer. - [x] YSD-14155 Handle source expiry/deletion by removing prohibited derivatives and replacing, suspending, or converting items without corrupting learning history. - [x] YSD-14156 Respect accessibility, time extension, non-timed alternatives, audio/visual modality, language, and cognitive-load preferences. - [x] YSD-14157 Add scheduler-version, due-state, rights, expired-source, answer ambiguity, accessibility, offline, and retention-effectiveness tests. ### 14.8 Onboarding, exemplars, and cold start - [x] YSD-14170 Curate expert-authored exemplar studies that demonstrate the complete question-to-decision loop on rights-cleared sources. - [x] YSD-14171 Let learners inspect, fork, redo, compare with, and cite exemplars without modifying the canonical exemplar. - [x] YSD-14172 Ingest selected Blender open movies with verified licenses, attribution, scripts, storyboards, scene files, and renders to exercise production-material and 3D study. - [x] YSD-14173 Instrument selected open-source games as seed Tier B/C content with reproducible build, connector, telemetry, license, and privacy documentation. - [x] YSD-14174 Build guided study-along walkthroughs with bounded question, prepared source, prompted blind observation, comparison, and first exercise. - [x] YSD-14175 Build template galleries for comparison sets, atlas facets, annotation templates, questions, exercises, inspiration collections, and project concept systems. - [x] YSD-14176 Provide persona-specific onboarding for filmmaker, game developer, performer/animator/director, visual designer, teacher, and researcher. - [x] YSD-14177 Add useful empty, partial-processing, no-model, no-permission, source-expired, and first-success states instead of generic onboarding cards. - [x] YSD-14178 Measure time to first authorized anchor, study card, comparison, exercise, and decision without collecting private content. - [x] YSD-14179 Add license verification, seed reproducibility, walkthrough completion, fork isolation, accessibility, localization, and no-network tests. ### 14.9 Teacher, mentor, team, and institutional workflows - [x] YSD-14200 Build source-safe study-set creation with rights/consent validation, audience, availability window, spoiler state, and allowed derivatives. - [x] YSD-14201 Build assignments for guided analyses, comparisons, exercises, first viewing, peer review, and portfolios. - [x] YSD-14202 Build evidence review, anchored comments, rubric publication, override, moderation, and learner challenge queues. - [x] YSD-14203 Build learner-growth views by concept/evidence dimension while avoiding taste, conformity, demographic, or opaque quality rankings. - [x] YSD-14204 Build cohort analytics with minimum-group thresholds, pseudonymization, consent, role controls, retention, and no access to unnecessary private content. - [x] YSD-14205 Build teaching-pack publication with rights, attribution, accessibility, localization, moderation, signature, version, expiry, and takedown. - [x] YSD-14206 EXT Add institutional policy for local processing, retention, minors, educator access, audit, export, account closure, and data residency. - [x] YSD-14207 Add teacher/learner role, source window, spoiler, rubric, challenge, moderation, cohort privacy, publication, expiry, and deletion tests. --- ## 15. Notebooks, outputs, exports, interoperability, and portability ### 15.1 Nisaba notebook and study-card integration - [x] YSD-15001 Persist notebooks and study cards through Nisaba's canonical model and preserve Nisaba IDs, versions, citations, permissions, and publication semantics. - [x] YSD-15002 Build atomic study cards containing question, claim, observations, evidence, confidence, dissent, context, limitations, taxonomy terms, and practice links. - [x] YSD-15003 Build notebook narratives combining source citations, annotations, comparison/matrix views, graph paths, tables, diagrams, questions, principles, attempts, outcomes, and decisions. - [x] YSD-15004 Let embedded views retain a frozen or live version policy and visibly report stale, changed, expired, contested, or inaccessible dependencies. - [x] YSD-15005 Implement draft, review, comment, approval, publish, retract, archive, fork, export, and delete while preserving immutable scholarly history. - [x] YSD-15006 Preserve disagreement and counterevidence in cards/notebooks and prevent synthesis from flattening them. - [x] YSD-15007 Add notebook autosave, collaboration conflict, offline queue, citation restore, rights change, source deletion, accessibility, and portability tests. ### 15.2 Rights-aware output formats - [x] YSD-15020 Export Markdown with citations, source/version metadata, epistemic labels, typed links, structured alt text, and rights-safe previews. - [x] YSD-15021 Export accessible PDF with tagged structure, reading order, captions, alt text, tables, page navigation, citations, and permitted media. - [x] YSD-15022 Export accessible presentation decks with speaker notes, citations, alt text, source/version identity, and permitted previews. - [x] YSD-15023 Export JSON portable manifests with schemas, stable IDs, anchors, relationships, versions, policy metadata, and no unauthorized media. - [x] YSD-15024 Export CSV for flat analytical tables with explicit epistemic, source, version, missing-value, locale, and permission semantics. - [x] YSD-15025 Export rights-permitted image contact sheets with source anchors, attribution, captions, alt text, order, and resolution limits. - [x] YSD-15026 Export edit markers and approved production formats with exact time-base, source version, marker intent, and destination compatibility. - [x] YSD-15027 Export teaching packs with exercises, rubrics, source access rules, spoilers, accessibility alternatives, version, signature, and expiry. - [x] YSD-15028 Export audit and reproducibility reports with policy decisions, versions, runs, reviews, citations, and excluded-content manifest. - [x] YSD-15029 Generate a preflight showing included, transformed, linked, excluded, redacted, downscaled, expiring, and blocked content before export. - [x] YSD-15030 Sign exports and record export identity, actor, audience, destination, grant, policy version, included source dependencies, expiry, and audit event. - [x] YSD-15031 Add format validation, accessibility, round-trip, permission, quote/clip limit, expired-source, tamper, large-project, and deletion tests. ### 15.3 W3C Web Annotation and linked data - [x] YSD-15050 Map compatible bodies, targets, selectors, motivations, provenance, authorship, review, and versions to W3C Web Annotation concepts without losing workspace semantics. - [x] YSD-15051 Reuse Nisaba reference-linked-data primitives and document every extension rather than creating a competing vocabulary. - [x] YSD-15052 Represent portable cross-references with stable IDs and JSON-LD- compatible relation semantics where practical. - [x] YSD-15053 Keep canvas coordinates optional presentation metadata rather than a semantic edge. - [x] YSD-15054 Preserve unsupported workspace fields in sidecars/extension contexts and fail loudly if an export target would lose required semantics. - [x] YSD-15055 Add import/export conformance, extension, unknown-field, identity, permission, round-trip, and external-validator tests. ### 15.4 IIIF, media, and production standards - [x] YSD-15070 Map rights-permitted still images and documents to IIIF Presentation/Image canvases, ranges, tiled services, annotations, and region selectors. - [x] YSD-15071 Preserve SMPTE-compatible timecode, rational frame rates, drop- frame semantics, reel/source identity, and proxy mapping. - [x] YSD-15072 Select and implement established subtitle, transcript, edit- marker, camera-report, sound-report, screenplay, storyboard, and production-metadata formats before proprietary alternatives. - [x] YSD-15073 Define engine-neutral game-session export plus approved Unreal, Unity, Godot, and product-specific adapter packages. - [x] YSD-15074 Support glTF/GLB for creator-owned 3D study while retaining native DCC/engine identifiers and richer metadata in versioned sidecars. - [x] YSD-15075 Export annotations/manifests separately from media so recipients can enforce their own source permissions. - [x] YSD-15076 Add standard-validator, source-to-proxy, timecode, IIIF region, subtitle/transcript, game-envelope, glTF, and sidecar round-trip tests. ### 15.5 Portable and offline study - [x] YSD-15090 Define a portable study manifest containing metadata, stable IDs, source references, anchors, epistemic objects, links, views, and versions without prohibited media. - [x] YSD-15091 Include embedded derivatives only when the grant permits the recipient, destination, resolution, duration, retention, and use. - [x] YSD-15092 Preserve stable deep links and provider/source identifiers across web, desktop, mobile companion, and imported packages. - [x] YSD-15093 Implement policy-approved desktop/local processing for sensitive footage with model packaging, sandboxing, resource limits, versioning, and later synchronization. - [x] YSD-15094 Implement a conflict-safe offline manual-note queue according to the approved collaboration model and policy. - [x] YSD-15095 Encrypt offline data, bind it to account/project/device policy, enforce local expiry/revocation, and support secure remote sign-out or key invalidation where feasible. - [x] YSD-15096 Make model-provider replacement possible through adapter contracts and provide export/migration of model-independent records. - [x] YSD-15097 Add offline create/edit/conflict, rights expiry, device clock, reconnect, provider replacement, encrypted storage, lost device, and portable-package tests. ### 15.6 Project transfer and production destinations - [x] YSD-15110 Let users select principles for palette, motion, shot logic, narrative function, sound, performance, costume, environment, mechanic, UI, accessibility, and production constraints. - [x] YSD-15111 Require source/rights/dependency review and show every affected anchor before transfer. - [x] YSD-15112 Transform selections into abstract constraints, questions, hypotheses, acceptance criteria, or tasks with original wording. - [x] YSD-15113 Support approved destinations for Yemaya project, game backlog, storyboard, shot list, character brief, animation task, sound brief, design document, test plan, and prototype. - [x] YSD-15114 Negotiate destination capabilities and preserve fields or report lossy conversion before delivery. - [x] YSD-15115 Strip or block prohibited clips, images, regions, audio, transcripts, protected assets, embeddings, and near-copy instructions. - [x] YSD-15116 Preserve source-to-principle-to-decision backlink and destination artifact/task ID. - [x] YSD-15117 Track delivery, acknowledgement, destination updates, outcome evidence, broken backlink, source expiry, and impact review. - [x] YSD-15118 Add destination contract, originality, rights, content stripping, backlink, idempotency, retry, rollback/compensation, and deletion tests. --- ## 16. Accessibility and internationalization ### 16.1 Accessibility architecture - [x] YSD-16001 Define WCAG target, supported assistive-technology matrix, browser/OS combinations, desktop baseline, accessible performance fallback, ownership, exception process, and release-blocking criteria. - [x] YSD-16002 Create semantic interaction specifications for player, timeline, annotation, comparison, inspiration canvas, graph, matrix, concept map, notebook, practice, dialogs, and live sessions before implementation. - [x] YSD-16003 Build reusable primitives for focus management, roving tab index, keyboard shortcuts, live regions, descriptive summaries, accessible drag/drop alternatives, resize, zoom, and error association. - [x] YSD-16004 Ensure every visualization has a semantically equivalent list, outline, structured table, text summary, or stepwise traversal—not merely a static description. - [ ] YSD-16005 Add automated axe/accessibility lint, component tests, Playwright keyboard tests, screen-reader critical-flow tests, and manual assistive-technology review evidence. _2026-09-18: the automated half (axe, component, Playwright keyboard and screen-reader-flow tests) is agent work; the "manual assistive-technology review evidence" needs a person and is the only part that may stay open after the automation is recorded._ ### 16.2 Player, timeline, and media accessibility - [x] YSD-16020 Provide complete keyboard operation for playback, shuttle, speed, reverse, loop, frame/event/word step, track selection, range selection, zoom, overlays, and bookmarks. - [x] YSD-16021 Provide accessible names, values, states, relationships, shortcut help, timecode, buffer state, errors, and change announcements. - [x] YSD-16022 Support captions, searchable transcripts, speaker labels, language/translation selection, transcript-follow playback, and correction. - [x] YSD-16023 Support audio-description tracks and user-authored visual- description notes where available. - [x] YSD-16024 Represent waveform, loudness, music cue, silence, and sound events textually and as keyboard-navigable intervals. - [x] YSD-16025 Encode track kinds, confidence, review states, differences, selections, and errors through text/shape/pattern/icon in addition to color. - [x] YSD-16026 Implement reduced-motion behavior for overlays, scrubbing, shared-selection transitions, synchronized views, graph layout, and motion analysis. - [x] YSD-16027 Provide configurable text size, contrast, focus appearance, timeline density, track height, control size, and playback controls without loss of content or function. - [x] YSD-16028 Provide one-handed and switch-access-friendly command paths where feasible and document any evidence-backed limitations. - [x] YSD-16029 Add captions/transcript, audio description, non-color, magnification, reflow, reduced-motion, switch/keyboard, and screen-reader playback tests. ### 16.3 Canvas, graph, matrix, and region accessibility - [x] YSD-16040 Provide complete keyboard operation for canvas navigation, image/region pinning, relation creation, graph traversal, grouping, comparison matrix editing, concept mapping, and decision inspection. - [x] YSD-16041 Provide screen-reader names, types, states, positions where useful, relationship summaries, active evidence path, rights/review status, and change announcements. - [x] YSD-16042 Provide non-spatial list/outline/table alternatives for canvas selection, grouping, reordering, link creation, traversal, and source-to- decision inspection. - [x] YSD-16043 Provide keyboard-reachable region descriptions and text alternatives for image crops, masks, polygons, poses, materials, and 3D selections. - [x] YSD-16044 Ensure a picture-to-picture connection never depends on line color, geometry, proximity, animation, or sight alone. - [x] YSD-16045 Preserve equivalent authoring and review capability in accessible alternatives rather than making them read-only. - [x] YSD-16046 Support accessible clustering/grouping summaries and bounded neighborhood expansion without flooding the accessibility tree. - [x] YSD-16047 Add keyboard/screen-reader task tests for pinning exact regions from several works, creating/reviewing a typed link, traversing to evidence, and committing a decision. ### 16.4 Learning and output accessibility - [x] YSD-16060 Support time extensions, pause/resume, untimed alternatives, alternate input/output modalities, and educator-defined accommodations in exercises. - [x] YSD-16061 Ensure blind/spoiler-safe exercises hide information from the accessibility tree and notifications as well as visually. - [x] YSD-16062 Provide accessible rubrics, feedback anchors, comparison differences, challenge workflow, mastery evidence, and portfolios. - [x] YSD-16063 Generate alt text and structured-table equivalents for contact sheets, diagrams, matrices, graphs, timelines, and project maps in exports. - [x] YSD-16064 Preserve headings, reading order, landmarks, language, captions, citations, links, table headers, and document tags in exported Markdown/PDF/presentation/HTML. - [ ] YSD-16065 EXT Add assistive-technology task-completion evaluations with disabled learners and accessibility experts for all critical journeys. Tagged EXT on 2026-08-16 per the convention above: seven of the eight critical journeys report `undeclared-modality`, which is decided before any session is run, so which assistive technology the workspace commits to supporting must be answered by a named owner before recruitment can close anything (decisions/ysd-16065.md). _Board tag 2026-09-18 (was the private word EXT): needs disabled learners and accessibility experts, and first a named owner's decision on which assistive technology is supported (decisions/ysd-16065.md)._ `blocked:human` `blocked:governance` ### 16.5 Internationalization and localization - [x] YSD-16080 Externalize UI copy, taxonomy labels, prompts, validation, notifications, help, exports, and event-display text with stable message IDs and context. - [x] YSD-16081 Support multiple dialogue, subtitle, transcript, commentary, translation, transliteration, and audio-description tracks without erasing original language identity. - [x] YSD-16082 Display translation source, model/human author, version, confidence, review, and known loss separately from source dialogue. - [x] YSD-16083 Search original text, translation, transliteration, and aliases while preserving the matched field/language and permitting language- specific ranking. - [x] YSD-16084 Implement locale-aware dates, numbers, names, collation, sort, pluralization, units, decimal separators, and user-facing timecode formatting without changing canonical time bases. - [x] YSD-16085 Implement right-to-left layout across shell, player-adjacent text, timeline labels, annotations, notebooks, graphs, matrices, dialogs, exports, and mixed-direction content. - [x] YSD-16086 Support cultural/regional taxonomy variants with owner, provenance, applicability, aliases, translations, and version migrations. - [x] YSD-16087 Warn that translation may not preserve rhythm, status, wordplay, rhyme, timing, meter, performance, or subtext and retain the original anchor. - [x] YSD-16088 Add pseudo-localization, text expansion, missing-message, RTL, mixed-script, collation, transcript alignment, transliteration, locale timecode, export, and search relevance tests. --- ## 17. Performance, reliability, scale, cost, offline, and observability ### 17.1 Performance budgets and measurement - [x] YSD-17001 Define representative hardware, browsers, networks, media, project sizes, cache states, source types, assistive settings, and measurement methodology for every performance budget. - [x] YSD-17002 Make cached source shell and metadata interactive within two seconds at p75 on the supported baseline. - [x] YSD-17003 Keep buffered local frame-step response below 100 ms on the supported baseline and report unsupported/provider-constrained cases. - [x] YSD-17004 Sustain 60 fps timeline pan/zoom and overlay toggles on the desktop baseline with a documented 30-fps accessible fallback. - [x] YSD-17005 Return the first useful ordinary project search page within one second and hybrid cross-modal page within three seconds. - [x] YSD-17006 Keep a 10,000-item inspiration collection filterable/searchable without eager-loading every preview. - [x] YSD-17007 Keep a filtered 5,000-node relationship view progressively expandable without attempting a full unreadable layout. - [x] YSD-17008 Keep manual annotation responsive during background analysis, projection rebuild, upload, export, and live collaboration. - [x] YSD-17009 Show durable job progress within one second and detect silent stalled work. - [x] YSD-17010 Aim for less than one displayed-frame synchronization error where the game connector supports it and always report measured drift/ uncertainty. - [x] YSD-17011 Add browser performance marks, server traces, query plans, worker metrics, decoder timing, memory profiles, and reproducible benchmark datasets. - [x] YSD-17012 Add CI/release performance gates with variance handling, baseline history, regression budgets, artifact retention, and representative cold/warm runs. ### 17.2 Reliability and conflict safety - [x] YSD-17030 Guarantee that acknowledged accepted annotations, notebook edits, rights decisions, decisions, feedback, and practice submissions survive process restart and failover. - [x] YSD-17031 Make analysis jobs retryable/idempotent and prevent duplicate outputs, charges, notifications, or review tasks. - [x] YSD-17032 Surface partial failure with preserved successful outputs, failed components, retry action, cost, stale state, and limitation. - [x] YSD-17033 Block access immediately after permission/rights loss and schedule durable derivative cleanup. - [x] YSD-17034 Preserve policy-permitted offline notes in a conflict-safe queue and explain unresolved merge states. - [x] YSD-17035 Back up and restore the complete relational chain across source versions, anchors, claims, graph, concepts, decisions, outcomes, notebooks, learning, rights, and audit. - [x] YSD-17036 Define SLOs and error budgets for API availability, job start/ completion, data durability, projection lag, search, live sessions, export, rights enforcement, and deletion. - [x] YSD-17037 Add load, failover, queue outage, database failover, object-store outage, index lag, duplicate event, network partition, clock skew, cancellation race, and restore chaos tests. ### 17.3 Scale and cost controls - [x] YSD-17050 Separate cheap metadata/manual workflows from expensive multimodal, cross-modal, project-aware, and generative runs in scheduling and UI. - [x] YSD-17051 Estimate duration, GPU class, CPU/memory, network, storage, derivative volume, monetary cost, and uncertainty before processing. - [x] YSD-17052 Deduplicate permitted features by exact source revision, model/configuration/code/taxonomy version, rights, and tenant boundary. - [x] YSD-17053 Prevent cross-tenant deduplication from exposing source existence, hashes, embeddings, cost, or cached outputs. - [x] YSD-17054 Use tiered proxies, tiled image access, lazy high-resolution frames, virtualized timelines/matrices, and bounded graph expansion. - [x] YSD-17055 Index only policy-permitted derivatives and remove/rebuild projections on policy change. - [x] YSD-17056 Enforce budgets and hard caps per tenant, project, user, source, lens, provider, model tier, run, time window, and export. - [x] YSD-17057 Provide cancellation, budget alert, approval threshold, cost attribution, quota dashboard, and operator override with audit. - [x] YSD-17058 Archive cold sources under rights/retention policy and rebuild disposable projections from authoritative records. - [x] YSD-17059 Run capacity tests for concurrent upload, playback, annotation, search, graph query, model jobs, game telemetry, live sessions, export, expiry, and deletion. ### 17.4 Observability and operator controls - [x] YSD-17070 Trace each request from UI through BFF, orchestrator, adapter, model/job, persistence, projection, and response using shared correlation context. - [x] YSD-17071 Emit metrics for ingest failure, parser rejection, sync drift, job latency, model quality, rights denial, deletion lag, projection lag, search relevance, accessibility errors, and cost. - [x] YSD-17072 Emit product metrics only from privacy-safe events and never include source content, private responses, biometric-like features, or sensitive labels. - [x] YSD-17073 Use structured logging with allowlisted fields, sensitivity classification, redaction tests, sampling, retention, and tenant-safe operator access. - [x] YSD-17074 Build per-analysis audit view for inputs, outputs, source/ analysis versions, models/configurations, reviewers, retries, latency, cost, quality tier, and policy decisions. - [x] YSD-17075 Build per-source lifecycle view for grants, accesses, derivatives, projections, exports, dependencies, expiry, deletion, and completion receipts. - [x] YSD-17076 Build per-decision impact view for source/principle paths, affected outputs, outcomes, changed dependencies, and open review tasks. - [x] YSD-17077 Alert on stuck deletion, expired-access leakage, cross-tenant denial/failure, queue backlog, projection lag, cost anomaly, signing failure, and model-quality regression. - [x] YSD-17078 Add actionable dashboards, runbooks, owners, severity, escalation, silence policy, synthetic probes, and incident-review links for every alert. - [x] YSD-17079 Add log/metric/trace privacy tests, missing-correlation tests, alert injection, runbook drills, and dashboard accuracy verification. ### 17.5 Deployment, rollout, and data residency - [x] YSD-17100 Define environments, region/tenant data placement, object/ database/index residency, model-provider routes, signing keys, backups, and deletion boundaries. - [x] YSD-17101 Build reproducible service, worker, web, connector, and local- processing artifacts with SBOMs, provenance, signatures, vulnerability gates, and rollback metadata. - [x] YSD-17102 Implement zero/low-downtime schema and event rollouts with compatibility windows, backfill monitoring, projection versioning, and rollback/forward-fix. - [x] YSD-17103 Roll out per source class, tenant, persona, lens, game connector, provider, export type, and project-transfer destination behind flags. - [x] YSD-17104 Implement shadow/evaluation-only modes for new analyzers and relationship suggestions before learner-visible enablement. - [x] YSD-17105 Add canary metrics and automatic/manual rollback thresholds for rights leakage, data loss, unsupported claims, accessibility regression, latency, cost, and job failures. - [x] YSD-17106 Document disaster recovery, regional outage, provider outage, model withdrawal, key compromise, connector revocation, data export, and tenant closure. - [x] YSD-17107 Perform and record restore, deletion, provider-failover, model-replacement, signing-key rotation, and rollback drills. --- ## 18. Evaluation, automated verification, and release gates ### 18.1 Rights-cleared evaluation program - [x] YSD-18001 Establish governance for versioned gold sets, annotation guides, adjudication, legitimate disagreement, licenses, consent, privacy, retention, access, publication, and deletion. - [ ] YSD-18002 EXT Recruit and record film educators, directors, actors, animators, editors, cinematographers, sound designers, costume specialists, game designers, accessibility experts, cultural reviewers, learners, and statistical/evaluation owners. _Board tag 2026-09-18 (was EXT): recruiting and recording people is not an agent's act._ `blocked:human` - [x] YSD-18003 Define expert conflict-of-interest, compensation, attribution, confidentiality, review, and withdrawal procedures. - [x] YSD-18004 Build dataset manifests with work/edition/build identity, licenses, allowed uses, source hashes/references, slices, annotation versions, adjudication, and known limitations. - [x] YSD-18005 Cover film, television, animation, cinematics, gameplay video, instrumented sessions, stills, concept art, scripts, storyboards, documents, paratexts, production assets, and creator-owned 3D/scenes. - [x] YSD-18006 Slice medium, genre, era, language, culture, acting tradition, animation tradition, production context, and synthetic/captured status. - [x] YSD-18007 Slice skin tone, age, disability presentation, gender expression, voice type, body variation, performance style, and privacy class without turning protected attributes into product inference. - [x] YSD-18008 Slice low light, stylized imagery, occlusion, crowds, edits, compression, noisy audio, missing tracks, alternate cuts, and damaged files. - [x] YSD-18009 Slice game genre, platform, frame rate, latency, camera type, controller, settings, accessibility modes, patch/build, telemetry gaps, and replay classification. - [ ] YSD-18010 Include beginner/expert annotations, agreement-appropriate tasks, interpretive disagreement, counterreadings, insufficient-context cases, and intentional unknowns. _Board tag 2026-09-18: gold-set content annotated by beginners and experts; it does not exist and cannot be invented._ `blocked:corpus` - [ ] YSD-18011 Include same-function, productive-contrast, bridge-reference, keep-distinct, whole-image, and region-level relation cases across media. _Board tag 2026-09-18: part of the same rights-cleared, expert-annotated gold set as YSD-18010._ `blocked:corpus` - [ ] YSD-18012 Include original-project paths with expert-reviewed source-to- principle-to-decision chains, deliberate contradictions, missing coverage, diverse sources, concentration, overly direct mapping, and unsupported exploration. _Board tag 2026-09-18: needs expert-reviewed source-to-decision chains; same gold set as YSD-18010._ `blocked:corpus` - [x] YSD-18013 Version evaluation data and prevent test-set contamination, unauthorized model training, leakage into examples, and silent post-hoc label changes. - [x] YSD-18014 Publish internal model cards/evaluation reports with failures, uncertainty, limitations, slice performance, reviewer disagreement, remediation, and release decision. ### 18.2 Technical quality metrics - [x] YSD-18030 Measure SourceWork and SourceEdition/build match accuracy, ambiguous-match handling, false merge, and keep-distinct accuracy. - [x] YSD-18031 Measure scene, shot, beat, speaker, word, sound-event, pose, object, action, contact, gameplay phase, and document-boundary precision/ recall with tolerance definitions. - [x] YSD-18032 Measure timecode, subtitle, commentary, transcript, proxy, and telemetry synchronization error plus drift/gap detection. - [x] YSD-18033 Measure tracking stability, region/mask accuracy, pose error, transcript error, OCR error, source-separation quality, and retrieval relevance by slice. - [x] YSD-18034 Measure confidence calibration, reliability curves, abstention, coverage, expected calibration error, and behavior under distribution shift rather than raw confidence magnitude. - [x] YSD-18035 Measure claim-to-anchor completeness, citation restore rate, unsupported-claim rate, epistemic misclassification, and creator-intent conflation. - [x] YSD-18036 Measure cross-reference precision, calibration, keep-distinct accuracy, explanation sufficiency, review workload, and false identity merge by relation type. - [x] YSD-18037 Measure source-to-decision path completeness, broken-edge rate, impact-analysis precision/recall, stale dependency detection, and permission leakage through traversal. - [x] YSD-18038 Prove search and graph permission leakage rate is zero across results, counts, facets, snippets, suggestions, paths, clusters, exports, caches, and timing probes. - [x] YSD-18039 Measure rights-decision correctness, expiry/revocation timing, blocked-action coverage, consent enforcement, and audit completeness. - [x] YSD-18040 Measure deletion completion and latency across object, relational, search, vector, graph, time-series, cache, export, local/offline, and model/intermediate stores. - [x] YSD-18041 Measure job success, retry recovery, idempotency, latency, cost, cancellation, partial success, stale-output, and duplicate-effect rates. - [x] YSD-18042 Define pass thresholds, confidence intervals, minimum slice sizes, abstention policy, regression budgets, and owner sign-off for every technical metric. ### 18.3 Human-centered quality metrics - [x] YSD-18060 Measure inter-rater agreement only where a shared correct answer is meaningful and measure disagreement coverage/context where it is not. - [x] YSD-18061 Measure learner ability to distinguish source fact, detection, observation, interpretation, hypothesis, creator statement, and practice result. - [x] YSD-18062 Measure improvement in source-based analysis, contextual humility, counterexample use, original transfer, revision, and explanation across attempts. - [x] YSD-18063 Measure teacher-rated usefulness, specificity, actionability, contestability, cultural safety, and imitation pressure of feedback. - [x] YSD-18064 Measure time and success rate to find, inspect, compare, and cite a useful exact moment/region/event. - [x] YSD-18065 Measure time and success rate to organize multiple works into an explainable inspiration system and trace a decision back to exact regions. - [x] YSD-18066 Measure ability to discover relevant contrasts, distant analogies, bridge references, and missing perspectives—not only close visual matches. - [x] YSD-18067 Measure critical-journey completion, error recovery, cognitive load, and satisfaction with keyboard, screen reader, magnification, captions, reduced motion, switch access, and alternative views. - [x] YSD-18068 Measure cultural-reviewer assessment of stereotyping, context loss, taxonomy transfer, universalism, harassment risk, and missing counterreadings. - [x] YSD-18069 Measure whether recommendations narrow projects toward one famous work, culture, style, period, medium, provider, or derivative cluster. - [x] YSD-18070 Pre-register study questions, sampling, metrics, analysis, and stopping rules where practical and publish limitations rather than overclaiming learning outcomes. ### 18.4 Product success metrics - [x] YSD-18080 Instrument privacy-safe time to first authorized evidence anchor and first completed study card. - [x] YSD-18081 Instrument weekly active study projects, returning-learner annotations, and interpretation-bearing versus source-only projects. - [x] YSD-18082 Instrument the proportion of projects reaching a comparison, exercise attempt, committed decision, or outcome review. - [x] YSD-18083 Instrument returning-learner rate at one, four, and twelve weeks segmented by persona without exposing sensitive study content. - [x] YSD-18084 Instrument the share of studies producing project transfers and learner-reported usefulness of transferred principles. - [x] YSD-18085 Add consent, minimization, retention, deletion, role access, small-cohort suppression, and no-dark-pattern rules to product analytics. - [x] YSD-18086 Keep product metrics subordinate to rights, safety, epistemic, accessibility, reliability, and quality gates; encode gates so metric pressure cannot bypass them. ### 18.5 Automated test portfolio - [x] YSD-18100 Run formatting, linting, typechecking, build, dependency- boundary, generated-contract drift, schema compatibility, and stub scans for every affected project. - [x] YSD-18101 Maintain unit tests for pure policy, identity, timecode, locator, relation, hierarchy, transformation, originality, scheduling, and analysis-normalization logic. - [x] YSD-18102 Maintain property-based and fuzz tests for locators, time bases, parsers, schemas, relation graphs, event envelopes, pagination, and permission filters. - [x] YSD-18103 Maintain PostgreSQL/object/index/queue integration tests for transactions, concurrency, idempotency, projection, rights changes, deletion, backup, and restore. - [x] YSD-18104 Maintain consumer/provider contract tests for BFF, orchestrator, every domain adapter, external provider, game connector, destination, and generated client. - [x] YSD-18105 Maintain security tests for authentication, authorization, cross-tenant access, SSRF, parser sandbox, prompt injection, secrets, malware, quotas, signing, provider callbacks, and connector spoofing. - [x] YSD-18106 Maintain privacy/consent tests for private performance, learners, minors, biometrics-like features, gameplay identifiers, cohort thresholds, export, revocation, and deletion. - [ ] YSD-18107 EXT Maintain accessibility automation and manual evidence for every critical keyboard, screen-reader, caption, transcript, contrast, zoom, reduced-motion, graph/canvas alternative, and export flow. Tagged EXT on 2026-08-19 per the convention above: four of the twenty-three surfaces are reached by no route, so six required (flow, surface) pairs have no possible instrument and no harness work can close them. The seven finished panels behind them are V1-SOP operator tooling this proposal never asks for, and whether they are mounted or retired is a product ruling on another initiative's deliverables (decisions/ysd-18107.md). _Board tag 2026-09-18 (was EXT): the open half is a product ruling on whether seven V1-SOP operator panels are mounted or retired (decisions/ysd-18107.md)._ `blocked:governance` - [x] YSD-18108 Maintain Playwright journeys for source ingest, rights decision, hierarchy correction, playback, annotation, comparison, image/region pin, typed link, notebook, exercise, transfer, expiry, deletion, and impact review. - [x] YSD-18109 Maintain game end-to-end tests for Tier A footage, HUD/input assists, Tier B connector, clock drift/gaps, event tracks, bookmark, replay, and Tier-boundary honesty. - [x] YSD-18110 Maintain performance/load tests for stated UI, search, graph, collection, job, API, game telemetry, live-session, export, and deletion budgets. - [x] YSD-18111 Maintain chaos/recovery tests for service/store/queue/index/ provider outage, duplicate event, worker crash, network partition, source expiry mid-operation, key rotation, restore, and regional failover. - [x] YSD-18112 Maintain gold-set evaluation and release comparison for every enabled analyzer, suggestion system, synthesis model, originality warning, and feedback model. - [x] YSD-18113 Store test/evaluation artifacts, failing examples, screenshots, traces, performance results, accessibility reports, and environment/ version metadata with the release candidate. ### 18.6 Mandatory release gates - [x] YSD-18130 Gate 1: prove every displayed analysis can open each authorized evidence anchor at the exact source/version/locator or clearly reports current inaccessibility. - [x] YSD-18131 Gate 2: prove every machine output exposes model/code, analysis run, configuration/version, confidence where applicable, and review state. - [x] YSD-18132 Gate 3: prove detections, observations, interpretations, hypotheses, creator statements, and intent claims cannot be silently conflated in API, UI, search, synthesis, feedback, or export. - [x] YSD-18133 Gate 4: prove restricted actions are blocked in playback, processing, embedding, search, graph traversal, collaboration, teaching, sharing, export, training, and project transfer. - [x] YSD-18134 Gate 5: prove expiry and deletion propagate through originals, derivatives, embeddings, indexes, graph, caches, exports, offline copies, and model/intermediate stores within the documented objective. - [x] YSD-18135 Gate 6: pass cross-tenant/project/user leakage tests for direct, inferred, aggregate, timing, cache, vector, graph, export, and live- session paths. - [x] YSD-18136 Gate 7: prove private performance and learner data have required consent, roles, access, audience, retention, correction, export, and deletion. - [x] YSD-18137 Gate 8: pass emotion-related bias, calibration, cultural, language, dignity, behavior-specific-language, abstention, and safety evaluation. - [x] YSD-18138 Gate 9: prove instrumented game analysis reports event/frame gaps, clock drift, sync uncertainty, replay classification, and build/ session identity. - [x] YSD-18139 Gate 10: pass keyboard, screen-reader, caption/transcript, contrast, reduced-motion, zoom/reflow, graph/canvas alternative, and accessible-export automation for critical journeys. - [x] YSD-18140 Gate 11: pass search relevance/diversity/permission, job reliability/idempotency, UI/API performance, graph/collection scale, and cost budgets on representative data. - [x] YSD-18141 Gate 12: prove an authorized source can be manually studied, annotated, compared, saved, exported, and deleted while optional models are unavailable. - [x] YSD-18142 Gate 13: prove practice feedback is evidence-linked, behavior-specific, contestable, role-labeled, culturally safe, and does not mandate imitation. - [x] YSD-18143 Gate 14: prove project transfer removes prohibited source expression and gives inspectable overly-specific/concentration warnings. - [x] YSD-18144 Gate 15: prove a user can pin whole images and exact regions from several works, create typed relationships, and traverse every edge to authorized evidence. - [x] YSD-18145 Gate 16: prove suggested links remain provisional until review and lookalike entities are never silently merged. - [x] YSD-18146 Gate 17: pass graph and discovery diversity, cultural-context, source-concentration, explanation, accessibility, keep-distinct, and zero-permission-leakage gates. - [x] YSD-18147 Gate 18: prove a committed original-project decision records principles, alternatives, transformation rationale, source paths, affected production artifacts, and dependency-impact behavior. - [x] YSD-18148 Gate 19: prove source/claim/decision changes and outcome evidence open accurate impact reviews without rewriting accepted scholarly or creative history. ### 18.7 Release decision and evidence package - [x] YSD-18160 Produce a requirement-by-requirement release evidence matrix linking every applicable checklist item to code, tests, reports, approvals, runbooks, and runtime proof. - [x] YSD-18161 Record all known limitations, unsupported sources, disabled lenses, failed slices, exceptions, debt, workarounds, and user-visible disclosure. - [x] YSD-18162 Require accountable owner sign-off for architecture, rights, legal, privacy, security, epistemic integrity, cultural safety, accessibility, reliability, model quality, learning, and operations. - [ ] YSD-18163 Run a production-like launch-readiness rehearsal including ingest, model outage, permission change, source expiry, incident, deletion, restore, rollback, support, and status communication. _Board tag 2026-09-18: a production-like rehearsal needs a deployed environment and a release candidate, neither of which is scheduled._ `blocked:release` - [x] YSD-18164 Publish signed release manifests for code, contracts, schemas, models, taxonomies, evaluation sets, connector SDKs, content packs, migrations, and operator runbooks. - [x] YSD-18165 Refuse release if any mandatory gate lacks direct evidence, relies on a narrower test than the requirement, or has an unresolved exception without explicit authorized acceptance. --- ## 19. Phased delivery, migration, and ecosystem expansion ### 19.1 Phase 0 — decisions, contracts, governance - [x] YSD-19001 Complete and approve the ownership, route, customer, source, rights, lens, game-integration, persistence, collaboration, originality, interoperability, and evaluation decisions in Section 0.2. - [x] YSD-19002 Publish and compatibility-test source, edition/build, anchor, epistemic, rights, analysis-run, inspiration, cross-reference, original-concept, creative-decision, adapter, API, and event contracts. - [x] YSD-19003 Complete the domain capability/reuse inventory and resolve every candidate as reuse, wrap, replace, explicitly disable, or defer with owner and reason. - [x] YSD-19004 Complete rights policy, private-performance consent, threat model, privacy model, retention/deletion, evaluation governance, and initial annotation guide. - [ ] YSD-19005 Build and license the initial rights-cleared gold-set slices before developing learner-visible model behavior against them. _Board tag 2026-09-18: building is agent work, licensing rights-cleared material is not; the slices do not exist. Note that Phases 1 to 5 were checked ahead of this item although it says "before"._ `blocked:corpus` - [ ] YSD-19006 Phase 0 exit: prove teams can implement independently without competing identities, evidence models, rights decisions, or duplicate domain engines. _Board tag 2026-09-18: a phase-exit gate; it follows YSD-19005._ `blocked:upstream` ### 19.2 Phase 1 — manual-first foundation - [x] YSD-19020 Ship the named walking skeleton first: one authorized local-file class, real persistence, rights decision, player/hierarchy, manual annotation, one notebook flow, one export, rights denial, and deletion. Same deliverable as YSD-1030; verify once and mark both together. - [x] YSD-19021 Ship the canonical route, project/source library, player, hierarchy, multitrack timeline, manual observations/claims, rights resolver, notebook, search, compare tray, and deep links. - [x] YSD-19022 Ship project-framed inspiration collections, whole-image and region pinning, manual typed links, coordinated views, and accessible list/outline alternatives. - [x] YSD-19023 Ship first-viewing and spoiler-safe states with no model dependency. - [x] YSD-19024 Ship rights-safe Markdown/JSON and approved first-release exports with signatures and deletion dependencies. - [x] YSD-19025 EXT Seed exemplar studies, selected Blender open-movie production material, selected open-source game footage, walkthroughs, and templates. - [x] YSD-19026 Keep authorized local files and approved provider deep links useful without advanced AI. - [x] YSD-19027 Pass deep Playwright coverage for ingest, annotate, compare, image/region pin, typed link create/traverse, save/reload, rights denial, export, expiry, deletion, keyboard, and screen-reader-critical flows. - [ ] YSD-19028 Phase 1 exit: prove a learner can complete a valuable film or gameplay-video study manually on production persistence. _Board tag 2026-09-18: a phase-exit gate that needs a learner completing a study on production persistence._ `blocked:human` ### 19.3 Phase 2 — reliable structural analysis - [x] YSD-19040 Ship real metadata probing, permitted proxies, thumbnails, waveform, transcript/speaker alignment, scene/shot suggestions, and basic object/pose tracks. - [x] YSD-19041 Ship hybrid metadata/taxonomy/text/semantic/visual search with rights, permission, epistemic, version, explanation, and zero-leakage behavior. - [x] YSD-19042 Ship human correction, calibration, model/version audit, reanalysis diff, partial failure, stale-output state, and gold-set gates. - [x] YSD-19043 Ship explainable similarity, semantic, contrast, function, keep-distinct, coverage-gap, and typed relation suggestions with review. - [x] YSD-19044 Ship edition/build alignment maps using reviewed audio/shot/ transcript/telemetry correspondences and explicit gaps. - [x] YSD-19045 Ship PureRef, Milanote, Are.na, Pinterest, and Zotero importers plus browser/desktop clipping as quarantined user-declared sources. - [x] YSD-19046 Replace or disable fixture/simulated Aja product paths and prove every enabled path processes real media. - [ ] YSD-19047 EXT Phase 2 exit: prove automation saves measurable time while every output remains source-bound, rights-aware, reviewable, versioned, and correctable. _Board tag 2026-09-18 (was EXT): "saves measurable time" is measured with real users._ `blocked:human` ### 19.4 Phase 3 — film craft lenses and performance atlas - [x] YSD-19060 Ship the approved first-release performance, camera, animation, narrative, edit, sound, costume, art-direction, character, and visual- design lens scope. - [x] YSD-19061 Ship the contextual anger-related atlas with facets, aligned channels, disagreement, counterexamples, blind observation, comparison, safety, and exercises. - [x] YSD-19062 Ship commentary/paratext alignment and creator-statement evidence starting with creator-owned or licensed sources. - [x] YSD-19063 Connect lens findings to Nisaba notebooks, Metis exercises, attempts, feedback, reflection, spaced review, and perceptual drills. - [ ] YSD-19064 Pass domain-expert, bias/culture, dignity, privacy, rights, accessibility, performance, calibration, and unsupported-claim gates for enabled lenses. _Board tag 2026-09-18: domain-expert, cultural and dignity gates are passed by named reviewers, not by an agent._ `blocked:human` - [ ] YSD-19065 Phase 3 exit: prove the primary filmmaking and performance- learning journey is coherent from exact source evidence through original practice. _Board tag 2026-09-18: a phase-exit gate; it follows YSD-19064._ `blocked:upstream` ### 19.5 Phase 4 — game study - [x] YSD-19080 Ship video-only game templates for mechanic, level, UI, camera, animation, audio, feedback, and performance study with explicit Tier A limits. - [x] YSD-19081 Ship HUD parsing, visible input-overlay recognition, and community-data import as reviewable, source-documented, versioned facts or video detections. - [x] YSD-19082 Ship versioned instrumented-session SDK, schema registry, connector conformance suite, and at least one first-party owned game integration. - [x] YSD-19083 Ship input, state, camera, animation, combat, AI, economy, narrative, UI/audio, technical, and accessibility event tracks. - [x] YSD-19084 Ship reproducible session bookmarks, replay/restore, encounter comparisons, hit-feel stack, clock drift/gap reporting, and privacy filtering. - [x] YSD-19085 Phase 4 exit: prove one external game works honestly in Tier A video mode and one owned game works deeply and reproducibly in Tier B/C. ### 19.6 Phase 5 — learning, collaboration, and production transfer - [x] YSD-19100 Ship courses/study sets, assignments, rubrics, attempts, accommodations, teacher review, learner challenge, mastery evidence, portfolios, teams, and governed publishing. - [x] YSD-19101 Ship live co-study with synchronized playback, anchored discussion, presence, moderation, privacy, reconnect, and claim crystallization. - [x] YSD-19102 Ship original film/game/world concept graphs, cross-work matrices, source-to-principle-to-decision paths, coverage/consistency, and change-impact review. - [x] YSD-19103 Ship advisory source diversity, missing perspective, concentration, overly direct mapping, unsupported assumption, and contradiction-as-question behavior. - [x] YSD-19104 Ship originality-aware transfers to approved film/game production artifacts with stripped prohibited expression and durable backlinks. - [x] YSD-19105 Ship playtest/screening/review/release outcome evidence and contextual principle track records. - [x] YSD-19106 EXT Validate whether a mobile review companion and offline note queue solve demonstrated learner needs before building beyond the policy-safe core. - [x] YSD-19107 If justified, ship a mobile review companion for playback-safe review, notes, assignments, feedback, spaced review, and notifications with mobile accessibility, offline conflict, device privacy, and automation coverage. - [ ] YSD-19108 Phase 5 exit: prove study reliably becomes deliberate practice, accountable original decisions, production work, and outcome-informed learning. _Board tag 2026-09-18: a phase-exit gate that needs learners and their outcomes over time._ `blocked:human` ### 19.7 Phase 6 — advanced analysis and ecosystem - [x] YSD-19120 Evaluate and ship higher-quality visual, motion, audio, multimodal, causal-comparison, and project-aware analysis only when versioned evaluation proves added value over the prior system. - [x] YSD-19121 Ship bridge-reference discovery, user-controlled similarity weighting, productive contrast, corpus clustering, and rights-aware cross- media analogy with explanation and diversity gates. - [x] YSD-19122 Define a signed third-party lens SDK with capability manifest, sandbox, least privilege, source/rights filters, output schemas, provenance, cost, observability, conformance, review, and revocation. - [x] YSD-19123 Define governed taxonomy extensions with owner, namespace, provenance, culture/language scope, compatibility, migration, moderation, and removal. - [x] YSD-19124 EXT Build teaching-pack marketplace mechanics only after rights, consent, moderation, accessibility, signature, payment/refund if any, version, expiry, takedown, and institutional controls are approved. RESOLVED 2026-08-14 by owner decision NOT to build (decisions/ysd-19124.md, approved by @GreyChimp): the ten controls were never approved for this purpose and are not being sought, so no marketplace mechanics exist to gate. The absence is enforced by vocabulary rather than intent — `APPROVED_TRANSFER_DESTINATIONS` is a closed list of ten production artifacts with no listing, storefront or marketplace destination in it, and `destinationCapabilities` throws `UnapprovedDestinationError` for anything off it, so there is no verb for selling a study to reach. Any future marketplace must sell the abstraction (principles, constraints, questions, tasks, criteria) and is a NEW decision recorded beside this one, never a widening of it. - [x] YSD-19125 Ship institutional controls for tenancy, role templates, moderation, minors, data residency, local processing, retention, export, audit, model policy, and support. - [x] YSD-19126 Ship local/private model execution and enterprise data-residency options with equivalent provenance, versioning, evaluation, observability, deletion, and adapter behavior. - [x] YSD-19127 Add third-party supply-chain, sandbox escape, contract conformance, permission leakage, model quality, cost, accessibility, revocation, and marketplace takedown tests. - [x] YSD-19128 Phase 6 exit: prove the ecosystem is extensible without weakening evidence, rights, privacy, accessibility, quality, operability, or deletion guarantees. ### 19.8 Specialist-app migration and deprecation - [x] YSD-19140 Inventory overlapping Aja/Yemaya specialist routes and classify each as canonical, embedded, redirected, internal-only, migrated, or deprecated. - [x] YSD-19141 Build compatibility redirects/deep-link translators that preserve source/anchor/project context and do not broaden permissions. - [x] YSD-19142 Migrate authorized persisted annotations/notebooks/references through versioned importers with dry run, reconciliation, rollback/ forward-fix, and audit. - [x] YSD-19143 Run parallel/shadow validation and compare data, rights, playback, annotations, search, and exports before cutover. - [x] YSD-19144 Communicate deprecation dates, user action, unsupported legacy fields, export options, and support channels. - [x] YSD-19145 Remove duplicate product paths only after traffic, data, dependency, rollback, retention, and user-impact evidence supports it. --- ## 20. Competitive patterns, research validation, and source ecosystem ### 20.1 Interaction-pattern benchmarking - [x] YSD-20001 Benchmark ELAN-style time-aligned multi-tier annotation and controlled-vocabulary workflows against the proposed timeline. - [x] YSD-20002 Benchmark ANVIL-style user-defined multimodal schemes against lens-specific annotation templates. - [x] YSD-20003 Benchmark VIAN-style palette-over-time and screenshot-region analysis against the visual-design lens. - [x] YSD-20004 Benchmark Advene-style annotations traveling separately from media against the portable manifest. - [x] YSD-20005 Benchmark Lignes de temps-style timeline-as-primary-document interaction against the workbench. - [x] YSD-20006 Benchmark Cinemetrics-style shot-rhythm statistics while retaining qualitative context and source/cut identity. - [x] YSD-20007 Benchmark ShotDeck, Flim, and Frame Set search/curation ergonomics while adding exact source anchors, explanations, rights, and review. - [x] YSD-20008 Benchmark PureRef canvas speed and low-friction composition so evidence/rights features do not destroy the artist's core interaction. - [x] YSD-20009 Benchmark Milanote and Are.na connected-board workflows while validating the value of typed, evidence-backed, reviewable links. - [x] YSD-20010 Benchmark StudioBinder and approved production tools as destinations for shot lists, breakdowns, briefs, and markers. - [x] YSD-20011 Benchmark GDC Vault/developer postmortems, Noclip-style consented archives, frame-data wikis, speedrun archives, replay systems, profilers, and analytics dashboards for game-side source patterns. - [x] YSD-20012 Record task-level usability, speed, accessibility, trust, discoverability, and transfer findings; update design/implementation requirements rather than copying visual styling. ### 20.2 Provider and corpus integrations - [x] YSD-20030 EXT Build a provider due-diligence matrix for target territories, playback APIs, source identity, token lifecycle, captions, deep links, analysis/derivative rights, sharing, teaching, export, retention, and deletion. - [x] YSD-20031 Implement only approved provider capabilities and return explicit unsupported states for playback/analysis features the provider does not authorize. - [x] YSD-20032 Monitor provider policy/API changes and open impact reviews for affected sources, annotations, study packs, decisions, and exports. - [x] YSD-20033 Establish verified ingestion/updates for selected open film, animation, game, image, document, and 3D production corpora. - [x] YSD-20034 Record corpus license/attribution/version changes and re-run rights, evaluation, deletion, and source-identity checks on updates. - [x] YSD-20035 Add provider sandbox, token revocation, availability, region, link rot, source-version, rights change, and deletion tests. - [x] YSD-20036 EXT Record an import-feasibility and terms-of-service decision for each reference-manager source named in YSD-5010 before building its importer: PureRef has no public API (import means parsing .pur files or user-exported images), Milanote export is limited, and Pinterest API access is restricted; implement only approved, rights-compatible import paths and return explicit unsupported states for the rest. --- ## 21. Explicit exclusions and anti-feature tests ### 21.1 Prohibited behaviors - [x] YSD-21001 Add architecture, policy, UI, and test guardrails against automatic universal emotion recognition. - [x] YSD-21002 Add guardrails against extracting assets from commercial games or inspecting project-aware structures without explicit authorization. - [x] YSD-21003 Add guardrails against DRM circumvention, access-control bypass, general streaming download, process injection, memory scraping, anti-cheat evasion, and archive decryption. - [x] YSD-21004 Add guardrails against fully automatic theme, cultural meaning, mental-state, influence, causal, or authorial-intent claims. - [x] YSD-21005 Add guardrails against global actor, filmmaker, learner, teacher, artist, game, culture, style, or creative-quality scores. - [x] YSD-21006 Add guardrails against training generative models on study sources by default or treating ordinary analysis permission as training permission. - [x] YSD-21007 Add guardrails against automatic entity merging from visual/ audio similarity and unreviewed influence or cultural-equivalence claims. - [x] YSD-21008 Add guardrails against one-click generation of a supposedly original world, film, game, character, or style from source material. - [x] YSD-21009 Keep a full nonlinear editor, DCC, and game engine outside the browser workspace scope; integrate through references and approved interchange. - [x] YSD-21010 Keep the system from presenting itself as a replacement for teachers, domain experts, legal review, cultural review, or factual/ authorial authority. - [x] YSD-21011 Add adversarial feature-discovery, API, plugin, prompt, configuration, import, connector, and export tests proving prohibited capabilities cannot be enabled accidentally. ### 21.2 Scope integrity - [x] YSD-21030 Preserve manual-first value and prevent later model features from making basic study model-dependent. - [x] YSD-21031 Preserve medium-specific semantics and prevent a film-centric timeline ontology from flattening documents, images, 3D assets, or games. - [x] YSD-21032 Preserve source-derived versus original-project graph separation and require abstract principles between protected evidence and production decisions. - [x] YSD-21033 Preserve canonical ownership and prevent the workspace service from becoming the motion, narrative, audio, garment, game, learning, identity, provenance, model-hosting, or audit engine. - [x] YSD-21034 Preserve context, disagreement, limitations, and unknowns as first-class data through every UI, API, export, synthesis, evaluation, and migration. - [x] YSD-21035 Preserve rights/privacy/deletion enforcement in offline, provider, third-party lens, marketplace, local-model, enterprise, and future-client extensions. --- ## 22. Definition of done and final completion audit ### 22.1 First coherent release — learner acceptance - [x] YSD-22001 Prove a learner can create a study project and add an authorized film clip or gameplay capture. - [x] YSD-22002 Prove the learner sees an explicit, inspectable rights decision for playback, processing, collaboration, teaching, sharing, export, retention, and transfer. - [x] YSD-22003 Prove the learner can navigate and correct source hierarchy with frame-accurate playback and exact source/version identity. - [x] YSD-22004 Prove the learner can add observations at scene, shot/phase, beat/action, frame/event, and region/entity levels. - [x] YSD-22005 Prove the agreed first-release lenses run on real media rather than fixtures, simulated success, or ungrounded model prose. - [x] YSD-22006 Prove every machine result exposes anchors, confidence where applicable, model/code/run/configuration, rights dependencies, limits, and review state. - [x] YSD-22007 Prove an interpretation is visibly and contractually distinct from detection, observation, creator statement, and authorial intent. - [x] YSD-22008 Prove the learner can compare several examples with synchronized alignment, explicit question, inclusion/exclusion, counterexamples, and uncertainty. - [x] YSD-22009 Prove the learner can pin whole images and exact regions from multiple works into a project-framed collection with relevance and do- not-copy notes. - [x] YSD-22010 Prove the learner can create/review typed connections across image, scene, sound, text, mechanic, principle, concept, decision, and output using visual and non-spatial accessible views. - [x] YSD-22011 Prove a matrix can compare more than eight corpus examples while focused synchronized playback works for two-to-eight. - [x] YSD-22012 Prove the learner can build an original film/game/world concept system from multiple abstract principles and inspect coverage, contradiction, missing perspective, concentration, and unsupported rationale. - [x] YSD-22013 Prove one committed creative decision has rationale, alternatives, intended effect, transformation, source/principle paths, owner/status, and production backlinks. - [x] YSD-22014 Prove a Nisaba-backed notebook retains durable citations, versions, embedded views, disagreement, rights state, and source trail. - [x] YSD-22015 Prove one finding becomes an original Metis exercise, attempt, evidence-linked feedback, learner challenge if needed, reflection, revision, and mastery evidence. - [x] YSD-22016 Prove an abstracted insight transfers into a Yemaya/game project without prohibited source expression and preserves a backlink. - [x] YSD-22017 Prove the entire critical journey is completable by keyboard and with the defined assistive-technology support. - [x] YSD-22018 Prove deleting/expiring a source removes access and handles originals, derivatives, indexes, graph projections, notebooks, exports, offline copies, and affected-decision reviews across every store. - [ ] YSD-22019 Pass all rights, privacy, security, epistemic, bias/cultural, accessibility, reliability, search, graph, performance, integration, evaluation, and end-to-end release gates. _Board tag 2026-09-18: the roll-up of every release gate; it follows YSD-18163, YSD-19064 and the gold set._ `blocked:upstream` ### 22.2 Broader vision acceptance - [x] YSD-22030 Prove the same evidence and learning model works across film, television, animation, performance, character/costume, art direction, sound/music, narrative/editing, still images, documents/storyboards, creator-owned 3D/scenes, and games. - [x] YSD-22031 Prove external games work honestly in video-only Tier A and owned games work reproducibly in instrumented/project-aware Tier B/C. - [x] YSD-22032 Prove cross-media comparison preserves functional analogy and medium-specific differences instead of flattening them. - [x] YSD-22033 Prove evidence can connect corpus to work to moment/image to region/event to principle to original concept to decision to production artifact to outcome and back. - [x] YSD-22034 Prove advanced discovery finds useful similarity, productive contrast, distant analogy, bridge references, counterexamples, and coverage gaps with user control and explanations. - [x] YSD-22035 Prove study outcomes continuously test principles without replacing contextual human judgment with automatic scores. - [x] YSD-22036 Prove third-party lenses, taxonomies, teaching packs, institutional controls, local models, and enterprise residency preserve every evidence, rights, privacy, accessibility, quality, and deletion invariant. - [x] YSD-22037 Prove the system supports durable, versioned, portable, standards-compatible research that remains useful when a provider, model, index, UI, or specialist app changes. ### 22.3 Requirement-by-requirement completion audit - [x] YSD-22050 Re-read the current proposal from beginning to end and enumerate every explicit requirement, numbered item, table row, invariant, metric, release gate, phase exit, decision, exclusion, and definition-of-done statement. - [x] YSD-22051 Reconcile the enumeration with this checklist and add any missing task before claiming completion. - [x] YSD-22052 For every checklist item, locate direct authoritative evidence: implemented code, migration, contract, passing targeted tests, rendered UI, runtime behavior, evaluation report, approval, runbook drill, or external-state proof. - [x] YSD-22053 Classify each item as proven, contradicted, incomplete, indirectly supported, or missing; treat indirect/uncertain evidence as incomplete. - [x] YSD-22054 Confirm tests cover the full requirement scope, including failure, permission, rights, expiry, deletion, accessibility, version, partial, offline, and scale behavior where applicable. - [x] YSD-22055 Confirm every external decision has named approval and a machine-enforced outcome; do not treat a proposed default as approval. - [x] YSD-22056 Confirm there are no remaining stubs, fixture-only production paths, silent catches, hard-coded success, in-memory-only stores, unauthorized bypasses, orphaned projections, or untested migrations. - [ ] YSD-22057 Confirm every mandatory release gate has fresh production-like evidence for the exact release candidate and representative datasets. _Board tag 2026-09-18: needs an exact release candidate, which does not exist yet._ `blocked:release` - [ ] YSD-22058 Confirm rollout, rollback, recovery, support, incident, expiry, deletion, backup/restore, provider change, model replacement, and tenant closure procedures have been exercised. _Board tag 2026-09-18: exercised against a deployed environment at release; see YSD-18163._ `blocked:release` - [x] YSD-22059 Confirm docs, API/event schemas, SDKs, examples, accessibility guidance, model cards, evaluation reports, data/rights notices, and operator runbooks match shipped behavior. - [x] YSD-22060 Confirm the current branch tip containing the completed checklist evidence is committed and present on origin/main with no local- only commit. - [ ] YSD-22061 Mark the program complete only when every in-scope item is proven, every approved exclusion is protected by tests, all required evidence is durable, and no unresolved release blocker remains. _Board tag 2026-09-18: the closing item; it follows everything above._ `blocked:upstream` --- ## Proposal-to-checklist coverage index | Proposal section | Primary checklist coverage | | --------------------------------------------- | ---------------------------- | | 1 Short answer | 0, 1, 22 | | 2 Executive summary | 0, 1, 7–15, 22 | | 3 Ownership decision | 0.2–0.3, 1.1, 6.2 | | 4 Thesis, goals, boundaries, principles | How to execute, 2, 4, 21, 22 | | 5 Current capability assessment | 0.1, 1.1, 19.1 | | 6 Users and jobs | 0.1, 7, 9–16, 18 | | 7 Core user journeys | 1.2, 5, 7–8, 10–15, 22.1 | | 8 Information architecture | 7–8, 16 | | 9 Granularity and evidence | 2, 3 | | 10 Comprehensive feature set | 5, 7–9, 13, 15 | | 11 Emotion and Performance Atlas | 10, 18 | | 12 Film-specific analysis | 9, 11 | | 13 Game-specific analysis | 9.10, 12 | | 14 Search, comparison, inspiration, synthesis | 13 | | 15 Learning and practice | 14 | | 16 Data and knowledge model | 2–3 | | 17 System architecture | 0–1, 6 | | 18 Ingestion and analysis pipeline | 5 | | 19 Contracts, APIs, events, interoperability | 2, 6, 15 | | 20 Rights, privacy, safety, integrity | 4, 10.5, 21 | | 21 Accessibility and internationalization | 16 | | 22 Non-functional requirements | 3, 17 | | 23 Evaluation and release gates | 18 | | 24 Delivery roadmap | 19 | | 25 Second-pass gap audit | 0, 2–5, 10–18, 21–22 | | 26 Decisions before build | 0.2 | | 27 Definition of done | 22 | | 28 Prior art and competitive positioning | 20 | | 29 Repository evidence | 0.1, 1.1 | | Final Recommendation | 0.2, 19, 22 | --- ## Checklist maintenance rule This file is a delivery control, not a static requirements summary. When the proposal, an ADR, a rights policy, an evaluation standard, or a supported integration changes, update the traceability ledger and this checklist in the same commit. Do not remove completed history to make progress look cleaner; supersede tasks with a reason, replacement task ID, migration evidence, and release impact.