# Style Development
#
# Cross-plan observations and invariants for how personal aesthetic
# decisions should emerge from this site work rather than be imported
# from outside it. This is a discovery document, not a style guide.

#>spw_style_development
#:conventions #!style
#:layer #!pragmatics

^"vocabulary"{
  ~#note: "Terms the site already uses to talk about its own aesthetic direction. These are starting points, not definitions."
  calm_at_rest: "The site's default register: legible, unhurried, structurally honest. Enhancements must not break this."
  summoned_delight: "Wonder that arrives through structural revelation or deliberate interaction, not through ambient decoration."
  inspectable_restraint: "The quality of a surface that is interesting because you can see how it works, not despite that."
  diagrammatic_warmth: "A visual quality to be defined from the site's own relational material — not borrowed from external design idioms."
  measured_delight: "Playfulness grounded in real measured data, not decorative caprice."
  legible_force: "Physical or metaphysical effects that remain readable and inspectable rather than opaque."
  earned_wonder: "Moments of structural revelation strong enough to feel magical without violating calm defaults."
}

^"emerging_observations"{
  ~#note: "What has already been observed about the emerging aesthetic. Update as the work surfaces new evidence."
  [
    "The constellation frame on the home page is the site's only committed visual vocabulary: sparse points, relational arcs, depth through layering.",
    "The operator atlas pages are the site's clearest voice: exact, relational, unhurried, with each sigil carrying both technical and metaphysical weight.",
    "Operator color tokens already form a visual hierarchy that is semantic, not decorative.",
    "The site's own metaphysics vocabulary (objective/subjective brace axis, charge, pivot, spirit phase, brace topology, and secondary valence) is a richer source for motifs and names than external design calendars or trends.",
    "Brace charge should appear first as readable recurrence: a sparse phrase or badge can charge attention and reveal similar language elsewhere.",
    "The spirit cycle's five phases (initiation, resistance, transformation, expression, return) are available as an interaction arc — none of the plans have yet claimed them.",
  ]
}

^"choice_points"{
  ~#note: "Where deliberate aesthetic decisions are needed and should be explicitly logged in the relevant plan's stream."
  css_ornament_motif: {
    plan: ".agents/plans/css-progressive-ornaments"
    commit: "4 — first seasonal proof"
    question: "What visual grammar does the first ornament belong to — and why this one?"
  }
  svg_visual_vocabulary: {
    plan: ".agents/plans/svg-surface-integration"
    commit: "4 — first authored illustration"
    question: "What does the site's diagram language commit to with this first illustration?"
  }
  pretext_physics_seed: {
    plan: ".agents/plans/pretext-whimsy-lab"
    commit: "4 — first physical projection"
    question: "Which Spw metaphysical concept seeds the first physics profile — and how?"
  }
  interaction_timing_vocabulary: {
    plan: ".agents/plans/mobile-runtime-foundation"
    commit: "2 — semantics formalization"
    question: "What naming and value choices characterize timing and transition constants on this site?"
  }
}

^"cross_plan_invariants"{
  "Style decisions should be logged in the relevant plan's stream at the commit they are first made.",
  "The site's own vocabulary (operators, metaphysics, brace topology, spirit phases) is the preferred source for names, motifs, and interaction analogues.",
  "Personal aesthetic choices should be identifiable in retrospect — each taste entry in a stream should explain what grammar the choice belongs to.",
  "Do not prescribe visual identity in advance of the work that earns it — but do mark the moments when choices are made.",
  "When departing from an established vocabulary (e.g., the constellation grammar), name the departure explicitly rather than leaving it implicit.",
}

^"protected_qualities"{
  ~#note: "Qualities to protect regardless of what style direction emerges."
  "Calm at rest: the default state of every page before interaction begins.",
  "Inspectability: any visual or interactive element that can be interrogated should be.",
  "Reversibility: aesthetic choices that trap or strand the visitor are style failures, not style preferences.",
  "Coherence: a seasonal ornament, a physics experiment, and an SVG illustration should be recognizable as belonging to the same sensibility.",
}

^"choice_points_extended"{
  ~#note: "Additional deliberate style decisions opened by new plans."
  screenshot_journey_tokens: {
    plan: ".agents/plans/screenshot-semantics"
    commit: "2 — screenshottable state taxonomy"
    question: "What visual form should a journey token take — and what does it say about how this site treats the record of engagement?"
  }
  cinematic_timing_vocabulary: {
    plan: ".agents/plans/cinematic-handles"
    commit: "3 — named timing tokens introduced"
    question: "What tempo do the first timing values define — and does that tempo match the site's written voice?"
  }
  brace_physics_vocabulary: {
    plan: ".agents/plans/interaction-grammar"
    commit: "2 — semantics formalization"
    question: "Decision logged: objective/subjective is the primary brace axis; boon/bane remains secondary valence. Future surfaces should test how physical intuition makes that axis legible."
  }
  filetype_visual_grammar: {
    plan: ".agents/plans/cognitive-navigation"
    commit: "2 — filetype taxonomy"
    question: "What visual signatures distinguish register, probe, reference, projection, surface, and metric — and do those signatures feel coherent with the existing operator color vocabulary?"
  }
}

^"spw_vision"{
 ~#note: "The unifying direction behind the new plans, from the user's note on 2026-04-10."
 cognitive_exercise: "Spw should be useful for exercising cognition and spatial relationship — the grammar makes visible spatial structure that is usually implicit."
 wonder_about_physics: "The site should create wonder about physics — not decorative physics, but the feeling that interaction has weight, tension, orbit, and settling from real measurement."
 other_languages_shine: "Spw should allow other languages and notations to demonstrate their own expressive power. Spw provides the host and the reflective grammar; the guest language teaches itself."
}

^"dispatch"{
  @site: ~"../site.spw"
  @semantics: ~"./site-semantics.spw"
  @css_plan: ~"../../.agents/plans/css-progressive-ornaments/wip.spw"
  @svg_plan: ~"../../.agents/plans/svg-surface-integration/wip.spw"
  @pretext_plan: ~"../../.agents/plans/pretext-whimsy-lab/wip.spw"
  @runtime_plan: ~"../../.agents/plans/mobile-runtime-foundation/wip.spw"
  @screenshot_plan: ~"../../.agents/plans/screenshot-semantics/wip.spw"
  @cinematic_plan: ~"../../.agents/plans/cinematic-handles/wip.spw"
  @circuits_plan: ~"../../.agents/plans/interaction-grammar/wip.spw"
  @nav_plan: ~"../../.agents/plans/cognitive-navigation/wip.spw"
}