@deftai/directive-content 0.55.0

package/vbrief/schemas/slices.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/slices-1.0.schema.json",
+  "title": "Slicing Cohort Record v1",
+  "description": "Frozen interface contract for one line in vbrief/.eval/slices.jsonl. Each line is a single JSON object recording one slicing event: an umbrella issue + the children produced from it. Slices.jsonl is APPEND-ONLY (existing lines are never edited or deleted) AND TRACKED IN GIT (sibling to the gitignored candidates.jsonl per vbrief/.eval/README.md tracking policy). Written by scripts/slice_record.py::write_slice; consumed by task triage:audit --orphans / --slice-stalled / --slice-coverage and by the D3 slice-wave-ready evaluator. Field set, types, and enums are FROZEN -- new fields may only be added in additive, optional positions in a follow-up schema version (D13 / #1132).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "slice_id",
+    "umbrella",
+    "umbrella_url",
+    "sliced_at",
+    "actor",
+    "children",
+    "expected_close_signal"
+  ],
+  "properties": {
+    "slice_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "RFC 4122 UUID (any version) uniquely identifying this cohort. Used by scripts/slice_record.py::write_slice for retry-dedup -- a re-write with the same slice_id is a no-op so a network blip mid-PR-create does not duplicate the cohort record.",
+      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+    },
+    "umbrella": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Umbrella issue number this cohort was sliced from."
+    },
+    "umbrella_url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Full URL of the umbrella issue (e.g. https://github.com/owner/repo/issues/1119)."
+    },
+    "sliced_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO-8601 UTC timestamp with literal Z suffix (e.g. 2026-05-13T18:00:00Z) when the slicing event was recorded.",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$"
+    },
+    "actor": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Slicing actor identity. v1 expected values: `skill:gh-slice`, `skill:gh-arch`, `skill:refinement`. The field is open-vocab so future slicing surfaces can append additional tags without a schema bump."
+    },
+    "children": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Children produced by the slicing event. Order is informational; the consumer joins on `n` (issue number).",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["n", "url", "wave", "role"],
+        "properties": {
+          "n": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Child issue number."
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Full URL of the child issue."
+          },
+          "wave": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "1-indexed wave number. Wave-1 children block (transitively) Wave-N>1 children of the same slice_id via the D3 `slice-wave-ready:<slice_id>:<wave>` atomic."
+          },
+          "role": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Short slicer-supplied tag describing the child's role (e.g. `structural`, `feature`, `docs`). Not semantically interpreted in v1 -- v1 is human readability only."
+          }
+        }
+      }
+    },
+    "expected_close_signal": {
+      "type": "string",
+      "enum": ["all-children-merged", "wave-1-merged", "manual"],
+      "description": "Operator-declared expected umbrella close signal. `all-children-merged` is the strict default; `wave-1-merged` is the lenient signal used when Wave-N>1 children are explicitly deferred via D3 `slice-wave-ready`; `manual` defers the close decision entirely to the operator."
+    },
+    "notes": {
+      "type": "string",
+      "description": "Optional free-form rationale captured at slice time."
+    }
+  }
+}

package/vbrief/schemas/strategies-pack.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/strategies-pack-0.1.schema.json",
+  "title": "Strategies Pack 0.1",
+  "description": "Canonical source schema for the strategies-pack-0.1 tier-3 extension pack (#1296, design #1283, ADR-001, generalizing the #1294 lessons pilot + #1295 skills pack). The structured JSON at packs/strategies/strategies-pack-0.1.json is the SOURCE OF TRUTH for strategy ROUTING METADATA: for every strategies/*.md it records id (the doc stem), title (the leading `# ` heading), description (the leading description paragraph), triggers (the strategy stem as an invocation keyword, used by the `by-trigger` slice), and the path. Exactly one designated proof strategy (strategies/yolo.md) also carries its full body so its markdown can be regenerated as a banner-marked, drift-checked projection (scripts/pack_render.py); every other entry is metadata-only (body null) and keeps its hand-authored markdown. The `x-sliceRegistry` block is the schema-declared, agent-facing slice API (mirrors lessons + skills): a named-slice registry mapping slice name -> { path (a constrained dotted path into the source -- NOT JSONPath), filters[] (the fixed trigger vocabulary), description }. Agents query by slice NAME only. The `x-display` block declares how scripts/packs_slice.py renders an entry as text (heading field, labelled metadata fields, optional body field, and the empty-result noun) so the slice formatter stays pack-agnostic.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["pack", "version", "strategies"],
+  "properties": {
+    "pack": {
+      "const": "strategies-pack-0.1",
+      "description": "Versioned pack identifier. The version lives in the name per #1283 Q6 (pack version is part of the pack name)."
+    },
+    "version": {
+      "const": "0.1",
+      "description": "Pack major.minor, mirrored from the pack name suffix."
+    },
+    "generated_from": {
+      "type": "string",
+      "description": "Provenance: the sources the one-shot migration (scripts/pack_migrate_strategies.py) parsed to build this pack (strategies/*.md)."
+    },
+    "strategies": {
+      "type": "array",
+      "description": "One entry per discovered strategy doc (strategies/*.md). Order is the sorted path order.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "description", "triggers", "path", "body"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Strategy id: the slugified doc stem (e.g. yolo, bdd, v0-20-contract)."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The strategy's leading `# ` heading text, stored verbatim."
+          },
+          "description": {
+            "type": "string",
+            "description": "The leading description paragraph after the title (Legend / See-also / chrome lines skipped), folded to a single normalised string. Empty when the doc has no leading paragraph."
+          },
+          "triggers": {
+            "type": "array",
+            "description": "Invocation keywords for this strategy (the doc stem). Empty when the strategy has no derivable trigger. The `by-trigger` slice filters on this field.",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^strategies/.+\\.md$",
+            "description": "Repo-relative path to the strategy markdown."
+          },
+          "body": {
+            "type": ["string", "null"],
+            "description": "Full strategy body (banner-stripped, verbatim) for the ONE designated proof strategy (strategies/yolo.md); null for metadata-only entries. The renderer reconstructs the proof = banner + body."
+          }
+        }
+      }
+    }
+  },
+  "x-display": {
+    "heading": "id",
+    "fields": ["title", "description", "triggers", "path"],
+    "body": null,
+    "noun": "strategies"
+  },
+  "x-sliceRegistry": {
+    "by-trigger": {
+      "path": "strategies",
+      "filters": ["trigger"],
+      "description": "Strategies whose invocation keywords include any of the requested --trigger values (case-insensitive, repeatable or comma-listed)."
+    },
+    "list": {
+      "path": "strategies",
+      "filters": [],
+      "description": "Every strategy with its title, description, triggers, and path."
+    },
+    "by-id": {
+      "path": "strategies",
+      "filters": ["id"],
+      "description": "Strategies whose id matches any of the requested --id values (e.g. yolo, bdd; case-insensitive, repeatable or comma-listed)."
+    }
+  }
+}

package/vbrief/schemas/swarm-spec-pack.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/swarm-spec-pack-0.1.schema.json",
+  "title": "Swarm Spec Pack 0.1",
+  "description": "Canonical source schema for the swarm-spec-pack-0.1 tier-3 extension pack (#1637, candidate from the #1283 Q-list, design #1283, ADR-001, generalizing the #1294 lessons pilot + #1295 skills pack + #1296 rules/strategies packs). The structured JSON at packs/swarm-spec/swarm-spec-pack-0.1.json is the SOURCE OF TRUTH for swarm-specification ROUTING METADATA: for every swarm/*.md it records id (the doc stem), title (the leading `# ` heading), description (the leading description paragraph), triggers (the doc stem as an invocation keyword, used by the `by-trigger` slice), and the path. The swarm spec is a single canonical document today, so its one entry is the designated proof and carries its full body, regenerated as a banner-marked, drift-checked projection (scripts/pack_render.py). The `x-sliceRegistry` block is the schema-declared, agent-facing slice API (mirrors lessons + skills + strategies + patterns): a named-slice registry mapping slice name -> { path (a constrained dotted path into the source -- NOT JSONPath), filters[] (the fixed trigger vocabulary), description }. Agents query by slice NAME only. The `x-display` block declares how scripts/packs_slice.py renders an entry as text (heading field, labelled metadata fields, optional body field, and the empty-result noun) so the slice formatter stays pack-agnostic.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["pack", "version", "entries"],
+  "properties": {
+    "pack": {
+      "const": "swarm-spec-pack-0.1",
+      "description": "Versioned pack identifier. The version lives in the name per #1283 Q6 (pack version is part of the pack name)."
+    },
+    "version": {
+      "const": "0.1",
+      "description": "Pack major.minor, mirrored from the pack name suffix."
+    },
+    "generated_from": {
+      "type": "string",
+      "description": "Provenance: the sources the one-shot migration (scripts/pack_migrate_swarm_spec.py) parsed to build this pack (swarm/*.md)."
+    },
+    "entries": {
+      "type": "array",
+      "description": "One entry per discovered swarm-spec doc (swarm/*.md). Order is the sorted path order.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "description", "triggers", "path", "body"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Entry id: the slugified doc stem (e.g. swarm)."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The doc's leading `# ` heading text, stored verbatim."
+          },
+          "description": {
+            "type": "string",
+            "description": "The leading description paragraph after the title (Legend / See-also / chrome lines skipped), folded to a single normalised string. Empty when the doc has no leading paragraph."
+          },
+          "triggers": {
+            "type": "array",
+            "description": "Invocation keywords for this entry (the doc stem). Empty when the entry has no derivable trigger. The `by-trigger` slice filters on this field.",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^swarm/.+\\.md$",
+            "description": "Repo-relative path to the swarm-spec markdown."
+          },
+          "body": {
+            "type": ["string", "null"],
+            "description": "Full doc body (banner-stripped, verbatim) for entries whose markdown is regenerated as a banner-marked, drift-checked projection; null for metadata-only entries. The single swarm spec doc is the proof and carries its body."
+          }
+        }
+      }
+    }
+  },
+  "x-display": {
+    "heading": "id",
+    "fields": ["title", "description", "triggers", "path"],
+    "body": null,
+    "noun": "swarm-spec entries"
+  },
+  "x-sliceRegistry": {
+    "by-trigger": {
+      "path": "entries",
+      "filters": ["trigger"],
+      "description": "Swarm-spec entries whose invocation keywords include any of the requested --trigger values (case-insensitive, repeatable or comma-listed)."
+    },
+    "list": {
+      "path": "entries",
+      "filters": [],
+      "description": "Every swarm-spec entry with its title, description, triggers, and path."
+    }
+  }
+}