dna-sdk 0.1.0

package/dist/extensions/sdlc/kinds/prompt-template.kind.yaml

@@ -0,0 +1,109 @@
+# PromptTemplate — versioned, overlayable user-prompt template
+# (record plane, GLOBAL scope; bundle storage, body = PROMPT.md after frontmatter).
+#
+# expr batch B (plan 2026-06-11-descriptor-expressiveness, Chunk 4): the twin
+# PromptTemplateKind classes (Py+TS) were DELETED — this descriptor is the
+# single source. It exercises FOUR descriptor fields the lote-3 skip flagged:
+#   - D2 summary: variables_count {count_of: variables}, body_length
+#     {count_of: body} (count_of over a STRING), default_locale plain.
+#   - D3 describe: {path: description}.
+#   - D4 ui_schema: pass-through Studio widget hints (the class's ui_schema).
+#   - D7 description_fallback_field: body.
+# The dead to_card (zero consumers) was NOT migrated.
+#
+# FIDELITY DELTA (port-canonical, pinned in the equivalence test): the class's
+# describe() returned `s.get("description") or None` (empty string → None);
+# the {path: description} projection returns "" verbatim. An empty-string
+# description is implausible (descriptions are human text).
+# PARITY-CRITICAL package data: byte-identical mirror at
+# packages/sdk-{py,ts}/{dna/extensions,src/extensions}/sdlc/kinds/
+# prompt-template.kind.yaml (test_descriptor_hash_parity enforces). Equivalence
+# frozen in tests/test_expr_batch_b_equivalence.py.
+apiVersion: github.com/ruinosus/dna/core/v1
+kind: KindDefinition
+metadata:
+  name: prompt-template
+spec:
+  target_api_version: github.com/ruinosus/dna/sdlc/v1
+  target_kind: PromptTemplate
+  alias: sdlc-prompt-template
+  origin: github.com/ruinosus/dna/sdlc
+  plane: record
+  prompt_target: false
+  flatten_in_context: false
+  prompt_target_priority: 0
+  is_runtime_artifact: false
+  storage:
+    type: bundle
+    container: prompts
+    marker: PROMPT.md
+    body_field: body
+  schema:
+    type: object
+    required:
+    - body
+    properties:
+      body:
+        type: string
+        description: Template text with {var} placeholders.
+      variables:
+        type: array
+        items:
+          type: string
+        default: []
+        description: Names of placeholders body expects.
+      description:
+        type: string
+      default_locale:
+        type: string
+      tags:
+        type: array
+        items:
+          type: string
+        default: []
+  # Authored projection — 1:1 with the extinct class summary(). body_length is
+  # count_of over a STRING (len(body or "")); variables_count over a list.
+  summary:
+    variables_count:
+      count_of: variables
+    body_length:
+      count_of: body
+    default_locale:
+      path: default_locale
+  # D3: the class's describe(doc) returned s.get("description") or None — the
+  # {path: …} projection returns the field as-is (or None). See the DELTA note.
+  describe:
+    path: description
+  # D7: the class declared description_fallback_field = "body".
+  description_fallback_field: body
+  # D4: Studio form widget hints — pass-through (the kernel does not interpret;
+  # the Studio form renderer owns the vocabulary). Verbatim from the class.
+  ui_schema:
+    body:
+      widget: markdown
+      label: Template body
+      help: Template with {placeholders}. Variables listed in frontmatter must match.
+      height: 320
+      order: 10
+    variables:
+      widget: list
+      label: Variables
+      help: Names of placeholders the body expects (e.g. scope, events_encoded).
+      order: 20
+    default_locale:
+      widget: text
+      label: Default locale
+      help: Optional. e.g. 'pt-br'. Caller may override.
+      order: 30
+  graph_style:
+    fill: '#0EA5E9'
+    stroke: '#0284C7'
+    text_color: '#fff'
+  ascii_icon: 📝
+  display_label: Prompt Templates
+  docs: A PromptTemplate is a versioned, overlayable user-prompt template owned by
+    the kernel — the declarative answer to 'where does the user prompt live?'. Callers
+    (typically Python helpers or HTTP endpoints) fetch the template by name and format()
+    it with per-call variables. Tenants can override the template body without touching
+    code. Templates can ship versioned with their consuming Kind (Narrative, StatusReport,
+    etc.) so prompt-engineering changes are reviewable diffs, not commits to call sites.

package/dist/extensions/sdlc/kinds/retrospective.kind.yaml

@@ -0,0 +1,186 @@
+# Retrospective — curated period summary: sprint / PI / release / incident
+# (record plane). Atlassian Team Playbook "4 Ls": what_went_well /
+# what_didnt / longed_for / learned + action_items. Distinct from ADR (one
+# decision) and Postmortem (one incident factual).
+#
+# F3 lote-1 (spec 2026-06-10-kinds-descriptor-f3): synthesized from this
+# descriptor; the twin RetrospectiveKind classes (Py+TS) were deleted.
+# PARITY-CRITICAL package data — byte-identical mirror under
+# packages/sdk-{py,ts}; tests/test_descriptor_hash_parity.py enforces.
+# O descriptor cura um drift Py↔TS: a classe TS tinha um summary() que o Py
+# de produção nunca serviu (list endpoints = kinds-api/Py) e um schema
+# magro sem descriptions — canônico é a superfície Py (sem summary).
+apiVersion: github.com/ruinosus/dna/core/v1
+kind: KindDefinition
+metadata:
+  name: retrospective
+spec:
+  target_api_version: github.com/ruinosus/dna/sdlc/v1
+  target_kind: Retrospective
+  alias: sdlc-retrospective
+  origin: github.com/ruinosus/dna/sdlc
+  tenant_scope: global
+  plane: record
+  prompt_target: false
+  flatten_in_context: false
+  prompt_target_priority: 0
+  storage:
+    type: bundle
+    container: retrospectives
+    marker: RETROSPECTIVE.md
+    body_field: body
+  dep_filters:
+    covers_features: sdlc-feature
+    covers_epics: sdlc-epic
+    covers_stories: sdlc-story
+    covers_session: sdlc-agent-session
+  schema:
+    type: object
+    required:
+    - title
+    - period_start
+    - period_end
+    properties:
+      title:
+        type: string
+        description: Headline for this retrospective.
+      period_start:
+        type: string
+        format: date-time
+        description: Start of period covered (ISO-8601).
+      period_end:
+        type: string
+        format: date-time
+        description: End of period covered.
+      intent:
+        type: string
+        enum:
+        - daily
+        - weekly
+        - sprint
+        - release
+        - incident
+        - freeform
+        description: What kind of retro this is. Drives Studio grouping — daily
+          stack on timeline, releases pin as marquee, incidents surface in alert
+          filter.
+      summary:
+        type: string
+        description: Optional one-line tl;dr (shown above body in Studio card).
+      what_went_well:
+        type: array
+        items:
+          type: string
+        description: 'Loved / Liked — things that worked in this period. Atlassian
+          4 Ls bucket #1.'
+      what_didnt:
+        type: array
+        items:
+          type: string
+        description: 'Loathed / Lacked — things that didn''t work or caused friction.
+          Atlassian 4 Ls bucket #2.'
+      longed_for:
+        type: array
+        items:
+          type: string
+        description: 'Longed for — capabilities/conditions wished for but absent.
+          Atlassian 4 Ls bucket #3.'
+      learned:
+        type: array
+        items:
+          type: string
+        description: 'Learned — insights surfaced during the period. Atlassian 4
+          Ls bucket #4. Feeds future ADRs.'
+      action_items:
+        type: array
+        items:
+          type: object
+          required:
+          - title
+          properties:
+            title:
+              type: string
+            owner:
+              type: string
+            due:
+              type: string
+              format: date
+            story_ref:
+              type: string
+              description: Optional Story slug if turned into work.
+        description: Concrete next-steps surfaced by the retro.
+      open_items:
+        type: array
+        items:
+          type: object
+          required:
+          - title
+          properties:
+            title:
+              type: string
+            owner:
+              type: string
+            blocker:
+              type: string
+        description: Work that started but didn't close — carry-over to next period.
+      covers_features:
+        type: array
+        items:
+          type: string
+        description: Feature names this retro discusses.
+      covers_epics:
+        type: array
+        items:
+          type: string
+        description: Epic names this retro discusses.
+      covers_stories:
+        type: array
+        items:
+          type: string
+        description: Story names this retro discusses.
+      covers_session:
+        type: string
+        description: AgentSession name (Karpathy pattern).
+      actor:
+        type: string
+        description: Who wrote this retro (Actor name, 'claude-code', 'human', ...).
+      auto_generated:
+        type: boolean
+        description: true = LLM-generated draft; false = human-curated.
+      narrative_origin:
+        type: string
+        description: When extracted from a Narrative during Phase 2.2 migration,
+          this points to the source Narrative slug for provenance.
+      tags:
+        type: array
+        items:
+          type: string
+        description: Free-form tags.
+      body:
+        type: string
+        description: Optional full markdown body (RETROSPECTIVE.md). Falls back
+          from structured fields when present.
+      created_at:
+        type: string
+        format: date-time
+      updated_at:
+        type: string
+        format: date-time
+  # Curated list/tree projection (campos do summary da classe TS extinta).
+  # DELTA INTENCIONAL: a classe Py ecoava o spec inteiro (KindBase default);
+  # list endpoints não usam summary() — produção inalterada.
+  summary:
+    title: ''
+    intent: ''
+    period_end: ''
+  graph_style:
+    fill: '#F59E0B'
+    stroke: '#D97706'
+    text_color: '#fff'
+  ascii_icon: 🔄
+  display_label: Retrospectives
+  docs: A Retrospective captures lessons + action items from a period of work. Schema
+    follows Atlassian 4 Ls (Loved/Loathed/Longed for/Learned) — what_went_well,
+    what_didnt, action_items. Adopt for sprint retros, release retros, incident
+    retros. For one architectural decision, use ADR. For one incident factual analysis,
+    use Postmortem (Phase 3 — TBD).

package/dist/extensions/sdlc/kinds/risk-register.kind.yaml

@@ -0,0 +1,178 @@
+# RiskRegister — one risk entry per doc, PMBOK 7 + ISO 31000:2018 (record
+# plane). The collection of RiskRegister docs in a scope IS the project's
+# risk register; Studio aggregates them into a likelihood × impact heatmap.
+#
+# F3 lote-2 (spec 2026-06-10-kinds-descriptor-f3): synthesized from this
+# descriptor; the hand-written class twins were deleted. PARITY-CRITICAL
+# package data — byte-identical mirror under packages/sdk-{py,ts};
+# tests/test_descriptor_hash_parity.py enforces. Equivalence vs the extinct
+# class frozen in tests/test_lote2_descriptor_equivalence.py (golden:
+# tests/goldens/lote2/RiskRegister.golden.json). Deltas intencionais (semântica
+# canônica = port): summary curado substitui o eco whole-spec do KindBase
+# default (list endpoints não usam kp.summary()); parse valida contra o
+# schema (classe era pass-through); to_card morto não migrado.
+apiVersion: github.com/ruinosus/dna/core/v1
+kind: KindDefinition
+metadata:
+  name: risk-register
+spec:
+  target_api_version: github.com/ruinosus/dna/sdlc/v1
+  target_kind: RiskRegister
+  alias: sdlc-risk-register
+  origin: github.com/ruinosus/dna/sdlc
+  tenant_scope: global
+  plane: record
+  prompt_target: false
+  flatten_in_context: false
+  prompt_target_priority: 0
+  storage:
+    type: bundle
+    container: risks
+    marker: RISK.md
+    body_field: body
+  dep_filters:
+    owner: helix-actor
+    related_features: sdlc-feature
+    related_epics: sdlc-epic
+  schema:
+    type: object
+    required:
+    - description
+    - category
+    - likelihood
+    - impact
+    - owner
+    - status
+    properties:
+      title:
+        type: string
+        description: Short risk name (used as doc name typically).
+      description:
+        type: string
+        description: 'Risk in cause→event→consequence format. ISO 31000 convention:
+          ''If <cause>, then <event> may occur, resulting in <consequence>''.'
+      category:
+        type: string
+        enum:
+        - strategic
+        - operational
+        - financial
+        - compliance
+        - reputational
+        - cyber
+        - ESG
+        description: PMBOK 7 categorization.
+      likelihood:
+        type: integer
+        minimum: 1
+        maximum: 5
+        description: 1=rare, 5=almost certain.
+      impact:
+        type: integer
+        minimum: 1
+        maximum: 5
+        description: 1=negligible, 5=catastrophic.
+      inherent_score:
+        type: integer
+        minimum: 1
+        maximum: 25
+        description: likelihood × impact (auto-derivable).
+      owner:
+        type: string
+        description: Actor name accountable for monitoring/mitigation.
+      response:
+        type: string
+        enum:
+        - avoid
+        - transfer
+        - mitigate
+        - accept
+        description: 'Strategy: avoid|transfer|mitigate|accept.'
+      mitigation_actions:
+        type: array
+        items:
+          type: object
+          required:
+          - action
+          properties:
+            action:
+              type: string
+            owner:
+              type: string
+            due:
+              type: string
+              format: date
+            story_ref:
+              type: string
+            status:
+              type: string
+              enum:
+              - todo
+              - in-progress
+              - done
+      residual_likelihood:
+        type: integer
+        minimum: 1
+        maximum: 5
+        description: Likelihood after mitigation.
+      residual_impact:
+        type: integer
+        minimum: 1
+        maximum: 5
+      residual_score:
+        type: integer
+        minimum: 1
+        maximum: 25
+      status:
+        type: string
+        enum:
+        - identified
+        - assessed
+        - mitigated
+        - realized
+        - closed
+        description: 'Lifecycle: identified → assessed → mitigated → (realized = risk
+          happened) → closed.'
+      last_reviewed:
+        type: string
+        format: date
+      next_review_due:
+        type: string
+        format: date
+      related_features:
+        type: array
+        items:
+          type: string
+      related_epics:
+        type: array
+        items:
+          type: string
+      tags:
+        type: array
+        items:
+          type: string
+      body:
+        type: string
+      created_at:
+        type: string
+        format: date-time
+      updated_at:
+        type: string
+        format: date-time
+  summary:
+    title: ''
+    category: ''
+    likelihood: null
+    impact: null
+    owner: ''
+    status: ''
+  graph_style:
+    fill: '#EAB308'
+    stroke: '#A16207'
+    text_color: '#fff'
+  ascii_icon: ⚠️
+  display_label: Risks
+  docs: 'One risk entry per RiskRegister doc. PMBOK 7 + ISO 31000:2018 compliant schema:
+    cause→event→consequence description, category, likelihood × impact scoring, mitigation
+    actions, residual score, owner, status lifecycle. Studio aggregates all RiskRegister
+    docs into a heatmap.'

package/dist/extensions/sdlc/kinds/saved-view.kind.yaml

@@ -0,0 +1,127 @@
+# SavedView — filter + groupBy + sort + layout persisted as a first-class
+# named view (record plane; Linear/Notion/Plane pattern). Loaded by the
+# Studio ViewToolbar "Load view" dropdown. tenant_scope: tenanted — views
+# are per-user/tenant personalization, unlike the global SDLC ledger.
+#
+# F3 lote-2 (spec 2026-06-10-kinds-descriptor-f3): synthesized from this
+# descriptor; the hand-written class twins were deleted. PARITY-CRITICAL
+# package data — byte-identical mirror under packages/sdk-{py,ts};
+# tests/test_descriptor_hash_parity.py enforces. Equivalence vs the extinct
+# class frozen in tests/test_lote2_descriptor_equivalence.py (golden:
+# tests/goldens/lote2/SavedView.golden.json). Deltas intencionais (semântica
+# canônica = port): summary curado substitui o eco whole-spec do KindBase
+# default (list endpoints não usam kp.summary()); parse valida contra o
+# schema (classe era pass-through); to_card morto não migrado.
+apiVersion: github.com/ruinosus/dna/core/v1
+kind: KindDefinition
+metadata:
+  name: saved-view
+spec:
+  target_api_version: github.com/ruinosus/dna/sdlc/v1
+  target_kind: SavedView
+  alias: sdlc-saved-view
+  origin: github.com/ruinosus/dna/sdlc
+  tenant_scope: tenanted
+  plane: record
+  prompt_target: false
+  flatten_in_context: false
+  prompt_target_priority: 0
+  storage:
+    type: bundle
+    container: saved-views
+    marker: SAVED_VIEW.md
+    body_field: body
+  dep_filters:
+    owner: helix-actor
+  schema:
+    type: object
+    required:
+    - title
+    - target_kind
+    - layout
+    properties:
+      title:
+        type: string
+        description: Human label (e.g. 'My open Stories', 'This sprint blocked').
+      description:
+        type: string
+      target_kind:
+        type: string
+        description: Kind name this view targets (Story, Bug, Spike, ...).
+      layout:
+        type: string
+        enum:
+        - board
+        - list
+        - tree
+        - table
+        - timeline
+        - calendar
+        - gallery
+        description: Visual layout pra render (board=group-by-status, list=flat, ...).
+      filters:
+        type: object
+        description: 'Filter spec — map property → value. E.g. {feature: ''f-X'',
+          owner: ''alice'', created_window: ''7d''}.'
+        additionalProperties: true
+      group_by:
+        type: string
+        description: Property to group by (status|feature|owner|priority|sprint|...).
+      sort_by:
+        type: string
+        description: Property to sort by.
+      sort_direction:
+        type: string
+        enum:
+        - asc
+        - desc
+        default: asc
+      visible_columns:
+        type: array
+        items:
+          type: string
+        description: Subset of properties shown (table layout). Empty = show all default
+          columns.
+      owner:
+        type: string
+        description: Actor name (creator). Determines edit permission.
+      visibility:
+        type: string
+        enum:
+        - private
+        - team
+        - shared
+        default: private
+      is_default:
+        type: boolean
+        default: false
+        description: Whether this view loads by default when opening the target Kind
+          list.
+      tags:
+        type: array
+        items:
+          type: string
+      body:
+        type: string
+      created_at:
+        type: string
+        format: date-time
+      updated_at:
+        type: string
+        format: date-time
+  summary:
+    title: ''
+    target_kind: ''
+    layout: ''
+    visibility: private
+    owner: ''
+    is_default: false
+  graph_style:
+    fill: '#06B6D4'
+    stroke: '#0E7490'
+    text_color: '#fff'
+  ascii_icon: 🔖
+  display_label: Saved Views
+  docs: Named view persisting filter + groupBy + sort + layout for a given Kind in
+    a scope. Linear/Notion/Plane pattern — views as first-class entities (não só URL
+    state). Load via ViewToolbar dropdown.