Recommended actions

• [Documentation problem | High] Add explicit private-table examples — Revise the Rust skill and concept cheat-sheet to show internal/scheduled tables without public, and state that public is only needed for client-facing tables. Evidence: t_002_scheduled_table, t_003_struct_in_table, t_008_index_lookup, t_039_cancel_schedule.
• [Documentation problem | High] Document event-table syntax — Add a concrete Rust example showing #[table(..., event)] and note that omitting event changes the schema. Evidence: t_024_event_table.
• [Documentation problem | Medium] Add canonical timestamp-construction examples — Document Timestamp::from_micros_since_unix_epoch(...) and Timestamp::UNIX_EPOCH for seeded data and time-window queries. Evidence: t_063_timestamp_window, t_069_scheduled_materialization.

Failure patterns

Overexposed tables (public added by default) (4 tasks)

• Classification: Documentation problem
• Confidence: High
• What the model wrote:
  • #[spacetimedb::table(accessor = tick_timer, scheduled(tick), public)]
  • #[spacetimedb::table(accessor = entity, public)]
  • #[spacetimedb::table(accessor = user, public)]
  • #[spacetimedb::table(accessor = cleanup_job, scheduled(run_cleanup), public)]
• What was expected:
  • #[table(accessor = tick_timer, scheduled(tick))]
  • #[table(accessor = entity)]
  • #[table(accessor = user)]
  • #[table(accessor = cleanup_job, scheduled(run_cleanup))]
• What the error says: schema_parity: failed
• Why this happened: The model appears to have generalized public from examples and applied it to internal or scheduled tables where it was not part of the expected schema.
• Suggested action: Revise the repository guidance to show private/internal tables as the default pattern and reserve public for client-readable tables.
• Suggested area: concepts/SKILL.md, rust-server/SKILL.md
• Affected tasks: t_002_scheduled_table, t_003_struct_in_table, t_008_index_lookup, t_039_cancel_schedule
• AI guidelines gap: No explicit warning that internal or scheduled tables should usually omit public.

Missing event-table attribute (1 task)

• Classification: Documentation problem
• Confidence: High
• What the model wrote:
  • #[spacetimedb::table(accessor = damage_event, public)]
• What was expected:
  • #[table(accessor = damage_event, public, event)]
• What the error says: schema_parity: failed
• Why this happened: The guidance described event tables conceptually, but did not provide the Rust attribute syntax needed to mark a table as an event table.
• Suggested action: Add a Rust example for event tables and explicitly state that event must be present in the table attribute.
• Suggested area: rust-server/SKILL.md
• Affected tasks: t_024_event_table
• AI guidelines gap: Missing syntax example for event tables.

Incorrect literal timestamp construction (2 tasks)

• Classification: Documentation problem
• Confidence: Medium
• What the model wrote:
  • let occurred_at = Timestamp::from_micros(t);
  • refreshed_at: Timestamp::from_micros(0),
• What was expected:
  • occurred_at: Timestamp::from_micros_since_unix_epoch(micros),
  • refreshed_at: Timestamp::UNIX_EPOCH,
• What the error says: publish_error: spacetime publish failed (exit=1) / schema_parity: failed
• Why this happened: The model had no explicit example for constructing literal Timestamp values, so it guessed a constructor name and zero-value form.
• Suggested action: Add timestamp seeding and window-query examples that use the canonical epoch-based constructor names.
• Suggested area: rust-server/SKILL.md
• Affected tasks: t_063_timestamp_window, t_069_scheduled_materialization
• AI guidelines gap: No explicit literal-timestamp construction example.