Skip to content
schema

External Signal Record

Properties

PropertyTypeRequiredDescription
typestringYes
sourcestringYesWhere the signal came from (e.g., "github-actions", "pr-42", "datadog").
timestampstringYes
summarystringYesOne-line summary of the signal.
detailsstringNoFull details (error message, review comment text, etc.).
learningstringNoExtracted learning or pattern to apply in future.
relevance_tagsarrayNo
affected_filesarrayNo

Full Schema

47 lines
yaml
$schema: "https://json-schema.org/draft/2020-12/schema"
$id: "https://sniper.ai/schemas/signal"
title: External Signal Record
deprecated: true
superseded_by: learning.schema.yaml
description: >
  DEPRECATED — Superseded by learning.schema.yaml.
  This schema is retained for backward compatibility. Existing signal files in
  .sniper/memory/signals/ will be migrated to learnings by the memory-curator
  agent on first run. Use /sniper-learn --review to trigger migration.
  Original description: Schema for SNIPER signal records that capture learnings
  from CI failures, PR reviews, and production errors.
type: object
required:
  - type
  - source
  - timestamp
  - summary
properties:
  type:
    type: string
    enum: [ci_failure, pr_review_comment, production_error, manual]
    description: Signal type classification.
  source:
    type: string
    description: Where the signal came from (e.g., "github-actions", "pr-42", "datadog").
  timestamp:
    type: string
    format: date-time
  summary:
    type: string
    description: One-line summary of the signal.
  details:
    type: string
    description: Full details (error message, review comment text, etc.).
  learning:
    type: string
    description: Extracted learning or pattern to apply in future.
  relevance_tags:
    type: array
    items: { type: string }
    description: Tags for matching against agent context.
  affected_files:
    type: array
    items: { type: string }
    description: File paths affected by this signal.
additionalProperties: false