Calendar

The community calendar is a shared event board: anyone can
            post upcoming events, invite specific people, and mark
            whether they're going.

            Usage:
              calendar                 list upcoming visible events
              calendar/list            same as above
              calendar/mine            events you authored or were invited to
              calendar/info <id>       full detail of one event

              calendar/create          spawn a blank event (you author it)
              calendar/title <id> <text>
              calendar/type <id> <socialeetingusiness|other>
              calendar/location <id> <text>
              calendar/description <id> drops into the EvEditor
              calendar/time <id> YYYY-MM-DD [HH:MM] set absolute UTC time
              calendar/shift <id> minutesours|days <signed-int>
              calendar/private <id>    toggle public/private
              calendar/invite <id> <name>[,<name>...]
              calendar/uninvite <id> <name>[,<name>...]
              calendar/hide <id> <name>[,<name>...]
              calendar/unhide <id> <name>[,<name>...]
              calendar/rsvp <id> goingaybe|decline
              calendar/cancel <id>     soft cancel; preserves history
              calendar/delete <id>     hard delete; only if no invitees/RSVPs

            Most edit switches require you to be the event's author.
            Staff can override via the @calendar admin command.

            # subtopics

            ## Browsing

            calendar/list shows every upcoming event you can see -- the
            public ones (minus any that explicitly hide you) plus the
            private ones you authored or were invited to. The table
            has columns for ID, Title, Type, when it starts (in
            Artemis time, with real UTC underneath), Location, and a
            count of Going RSVPs.

            calendar/info <id> gives the full readout: title, type,
            dual time, location, description, RSVP counts, and (if
            you're the author of a private event) the invitee list
            rendered through your recog -- you see invitees by the
            names you know them by, not by character keys.

            ## Authoring an event

            calendar/create makes a blank event titled "Untitled
            Event", scheduled for one day from now, public, no
            description. You'll get back the new event's ID; use it
            for all the edit switches.

            Typical flow:

              > calendar/create
              Created Event #7.
              > calendar/title 7 Hexline Drinks
              > calendar/location 7 The Hexline
              > calendar/type 7 social
              > calendar/time 7 2187-06-12 22:00
              > calendar/description 7
              [...EvEditor opens; type the description, then :wq]

            Each character may have at most 5 non-cancelled future
            events authored at a time. The 6th create is refused.

            ## Time: absolute vs shift

            Two ways to set when the event starts:

              /time <id> 2187-06-12          (Artemis date, midnight UTC)
              /time <id> 2187-06-12 19:00    (Artemis date + time, UTC)
              /shift <id> hours 5            (push 5 hours later)
              /shift <id> days -1            (pull 1 day earlier)

            Neither command will let you set the event's start time
            in the past.

            Artemis runs 10x real-time, so an event 10 in-game
            hours away fires in 1 real hour. The calendar/info
            display shows both clocks; the calendar list shows the
            Artemis time prominently and the UTC time in parentheses.

            ## Visibility: public vs private + hide list

            By default events are public: anyone can see them on
            the calendar and the website. Toggle with /private:

              > calendar/private 7
              Event is now private.

            Public events can be hidden from specific characters via
            /hide (using their recog name -- see below):

              > calendar/hide 7 Sundown
              Hidden from: Sundown

            Private events use an explicit invite list; only you
            and invitees can see them:

              > calendar/invite 7 Sundown, Vista
              Invited: Sundown, Vista

            Both lists use the recog system.

            ## Inviting via recog

            You can only invite people you know by name. The system
            looks up each name through your own recog -- the names
            you've explicitly remembered via recog <obj> as <name>
            or that you've learned through an introduction. If a name
            doesn't match any recog, but the person you mean is in
            the same room, their sdesc is tried as a fallback.

            If a name can't be resolved (no recog match, not in your
            room), or matches two people you've recog'd with the
            same name, the whole invite is rejected with no changes:

              > calendar/invite 7 Sundown, Nobody
              Did not apply -- the following names could not be resolved:
                - Could not resolve 'Nobody' through recog or local sdesc.

            What the invitee sees is rendered through their recog,
            not yours. They never see your character's key just
            because you invited them.

            ## RSVP

            Anyone who can see the event can RSVP:

              > calendar/rsvp 7 going
              > calendar/rsvp 7 maybe
              > calendar/rsvp 7 decline

            Your latest answer wins (the RSVP is upserted, not
            appended). Counts are visible on the info screen.

            ## Cancelling and deleting

            /cancel is the soft option -- the event stays visible
            with a [CANCELLED] marker for 7 in-game days, then
            drops off the upcoming list. RSVPs and invitees survive
            so attendees see the change.

            /delete is the hard option -- only allowed if no one
            has been invited and no one has RSVP'd. Use /cancel
            in any other case.

            ## Website

            Everything in the calendar is also exposed at
            /calendar/ on the website. Logged-out visitors see
            public events only; logged-in players see additionally
            the private events their last-puppeted character was
            invited to or authored, with invitee names rendered
            through that character's recog. RSVP and edit are
            available from the detail page when you're logged in.

            ## Staff commands

            Story Runners and admins use the @calendar command
            to override author checks, force-cancel, force-delete
            (bypassing the invitee/RSVP guard), and to listall events
            including private ones they weren't invited to. The
            ordinary calendar command stays the everyday tool.