@bvdm/delano 0.1.5 → 0.1.8

package/assets/payload/.agents/schemas/artifacts/plan.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/artifacts/plan.schema.json",
+  "title": "Delano project plan frontmatter",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "name",
+    "status",
+    "lead",
+    "created",
+    "updated",
+    "linear_project_id",
+    "risk_level",
+    "spec_status_at_plan_time"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "planned",
+        "active",
+        "done",
+        "deferred"
+      ]
+    },
+    "lead": {
+      "type": "string",
+      "minLength": 1
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "linear_project_id": {
+      "type": "string"
+    },
+    "risk_level": {
+      "enum": [
+        "low",
+        "medium",
+        "high"
+      ]
+    },
+    "spec_status_at_plan_time": {
+      "enum": [
+        "planned",
+        "active",
+        "complete",
+        "deferred"
+      ]
+    },
+    "target_version": {
+      "type": "string"
+    },
+    "operating_mode": {
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+        "patch",
+        "scoped-change",
+        "feature",
+        "uncertain-feature",
+        "multi-stream"
+      ]
+    }
+  }
+}

package/assets/payload/.agents/schemas/artifacts/spec.schema.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/artifacts/spec.schema.json",
+  "title": "Delano project spec frontmatter",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "name",
+    "slug",
+    "owner",
+    "status",
+    "created",
+    "updated",
+    "outcome",
+    "uncertainty",
+    "probe_required",
+    "probe_status"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "planned",
+        "active",
+        "complete",
+        "deferred"
+      ]
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "outcome": {
+      "type": "string",
+      "minLength": 1
+    },
+    "uncertainty": {
+      "type": "string",
+      "minLength": 1
+    },
+    "probe_required": {
+      "enum": [
+        "true",
+        "false",
+        true,
+        false
+      ]
+    },
+    "probe_status": {
+      "enum": [
+        "not-started",
+        "pending",
+        "completed",
+        "skipped"
+      ]
+    },
+    "source_review": {
+      "type": "string"
+    },
+    "external_reference": {
+      "type": "string"
+    },
+    "target_version": {
+      "type": "string"
+    },
+    "operating_mode": {
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+        "patch",
+        "scoped-change",
+        "feature",
+        "uncertain-feature",
+        "multi-stream"
+      ]
+    }
+  }
+}

package/assets/payload/.agents/schemas/artifacts/task.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/artifacts/task.schema.json",
+  "title": "Delano task frontmatter",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "id",
+    "name",
+    "status",
+    "workstream",
+    "created",
+    "updated",
+    "linear_issue_id",
+    "github_issue",
+    "github_pr",
+    "depends_on",
+    "conflicts_with",
+    "parallel",
+    "priority",
+    "estimate"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^T-[0-9]{3}$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "ready",
+        "in-progress",
+        "blocked",
+        "done",
+        "deferred"
+      ]
+    },
+    "workstream": {
+      "type": "string",
+      "pattern": "^WS-[A-Za-z0-9]+$"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "linear_issue_id": {
+      "type": "string"
+    },
+    "github_issue": {
+      "type": "string"
+    },
+    "github_pr": {
+      "type": "string"
+    },
+    "depends_on": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^T-[0-9]{3}$"
+      },
+      "uniqueItems": true
+    },
+    "conflicts_with": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^T-[0-9]{3}$"
+      },
+      "uniqueItems": true
+    },
+    "parallel": {
+      "enum": [
+        "true",
+        "false",
+        true,
+        false
+      ]
+    },
+    "priority": {
+      "enum": [
+        "low",
+        "medium",
+        "high"
+      ]
+    },
+    "estimate": {
+      "enum": [
+        "S",
+        "M",
+        "L",
+        "XL"
+      ]
+    },
+    "operating_mode": {
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+        "patch",
+        "scoped-change",
+        "feature",
+        "uncertain-feature",
+        "multi-stream"
+      ]
+    }
+  }
+}

package/assets/payload/.agents/schemas/artifacts/update.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/artifacts/update.schema.json",
+  "title": "Delano update frontmatter",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "date": { "type": "string", "format": "date-time" },
+    "related_task": { "type": "string", "pattern": "^T-[0-9]{3}$" },
+    "status": { "type": "string", "minLength": 1 }
+  }
+}

package/assets/payload/.agents/schemas/artifacts/workstream.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/artifacts/workstream.schema.json",
+  "title": "Delano workstream frontmatter",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "name",
+    "status",
+    "owner",
+    "created",
+    "updated"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^WS-[A-Za-z0-9]+$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "planned",
+        "active",
+        "done",
+        "deferred"
+      ]
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "child_project": {
+      "type": "string"
+    },
+    "operating_mode": {
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+        "patch",
+        "scoped-change",
+        "feature",
+        "uncertain-feature",
+        "multi-stream"
+      ]
+    }
+  }
+}

package/assets/payload/.agents/schemas/evidence-map.json

@@ -0,0 +1,53 @@
+{
+  "schema_version": 1,
+  "status": "draft",
+  "purpose": "Maps task acceptance criteria to proof signals required before a task can be treated as done.",
+  "done_task_rules": [
+    {
+      "id": "acceptance-criteria-checked",
+      "description": "Done tasks must have no unchecked acceptance criteria."
+    },
+    {
+      "id": "evidence-log-present",
+      "description": "Done tasks must have an Evidence Log section with at least one implementation evidence item."
+    },
+    {
+      "id": "repo-inspection-proof",
+      "acceptance_criterion_contains": "repo state has been inspected",
+      "proof_terms": [
+        "inspected"
+      ]
+    },
+    {
+      "id": "representation-proof",
+      "acceptance_criterion_contains": "represented in Delano runtime assets",
+      "proof_terms": [
+        "added",
+        "updated",
+        "wired",
+        "rebuilt",
+        "represented",
+        "mirrored"
+      ]
+    },
+    {
+      "id": "validation-proof",
+      "acceptance_criterion_contains": "validated with the smallest meaningful command",
+      "proof_terms": [
+        "validation passed",
+        "passed:",
+        "npm test",
+        "check:",
+        "Validation:"
+      ]
+    },
+    {
+      "id": "evidence-recorded-proof",
+      "acceptance_criterion_contains": "Evidence is recorded",
+      "proof_terms": [
+        "Evidence Log"
+      ]
+    }
+  ],
+  "strict_since": "2026-04-29T00:00:00Z"
+}

package/assets/payload/.agents/schemas/learning/closeout-learning-proposal.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/learning/closeout-learning-proposal.schema.json",
+  "title": "Delano closeout learning proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "project", "task_ids", "proposal_type", "title", "rationale", "target_paths", "review_gate", "adoption_status"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "project": { "type": "string", "minLength": 1 },
+    "task_ids": { "type": "array", "items": { "type": "string", "pattern": "^T-[0-9]{3}$" }, "minItems": 1 },
+    "proposal_type": { "enum": ["rule", "skill", "schema", "fixture"] },
+    "title": { "type": "string", "minLength": 1 },
+    "rationale": { "type": "string", "minLength": 1 },
+    "target_paths": { "type": "array", "items": { "type": "string", "not": { "pattern": "^/" } }, "minItems": 1 },
+    "review_gate": { "enum": ["required-before-adoption"] },
+    "adoption_status": { "enum": ["proposed", "accepted", "rejected", "deferred"] },
+    "evidence": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/assets/payload/.agents/schemas/learning/delivery-metric-event.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/learning/delivery-metric-event.schema.json",
+  "title": "Delano delivery metric event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "event_id", "event_type", "project", "task_id", "occurred_at", "privacy"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "event_id": { "type": "string", "pattern": "^evt-[0-9TZ-]+-[a-z0-9-]+$" },
+    "event_type": { "enum": ["task_started", "validation_passed", "validation_failed", "task_completed", "blocked", "handoff_created"] },
+    "project": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "task_id": { "type": "string", "pattern": "^T-[0-9]{3}$" },
+    "occurred_at": { "type": "string" },
+    "duration_seconds": { "type": "number", "minimum": 0 },
+    "validation_command": { "type": "string" },
+    "outcome": { "enum": ["pass", "fail", "blocked", "info"] },
+    "privacy": { "enum": ["summary-only", "local-detail"] },
+    "notes": { "type": "string" }
+  }
+}

package/assets/payload/.agents/schemas/leases/lease.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/leases/lease.schema.json",
+  "title": "Delano multi-agent path lease",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "lease_id", "owner", "project", "task_id", "status", "mode", "paths", "conflict_zones", "created_at", "acquired_at", "expires_at"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "lease_id": { "type": "string", "pattern": "^lease-[0-9TZ._-]+-[a-z0-9-]+$" },
+    "owner": {
+      "oneOf": [
+        { "type": "string", "minLength": 1 },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["agent_id", "stream"],
+          "properties": {
+            "agent_id": { "type": "string", "minLength": 1 },
+            "stream": { "type": "string", "minLength": 1 },
+            "task": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "project": { "type": "string", "minLength": 1 },
+    "task_id": { "type": "string", "pattern": "^T-[0-9]{3}$" },
+    "mode": { "enum": ["shared", "exclusive"] },
+    "paths": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "not": { "pattern": "^/" } } },
+    "conflict_zones": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "not": { "pattern": "^/" } } },
+    "created_at": { "type": "string" },
+    "acquired_at": { "type": "string" },
+    "expires_at": { "type": "string" },
+    "released_at": { "type": "string" },
+    "status": { "enum": ["active", "expired", "released"] },
+    "release_reason": { "type": "string" },
+    "handoff_summary": { "type": "string" }
+  }
+}

package/assets/payload/.agents/schemas/metrics/delivery-event.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/metrics/delivery-event.schema.json",
+  "title": "Delano privacy-safe delivery metric event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "event_id", "event_type", "project", "created_at", "source", "privacy", "summary"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "event_id": { "type": "string", "pattern": "^metric-[0-9TZ._-]+-[a-z0-9-]+$" },
+    "event_type": { "enum": ["task-status-change", "validation-run", "sync-drift", "evidence-gap", "blocked-time", "closeout-learning"] },
+    "project": { "type": "string", "minLength": 1 },
+    "task_id": { "type": "string", "pattern": "^T-[0-9]{3}$" },
+    "created_at": { "type": "string" },
+    "source": { "enum": ["local-runtime", "pm-validation", "sync-inspection", "closeout"] },
+    "privacy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["raw_text_allowed", "summary_only", "redaction_required"],
+      "properties": {
+        "raw_text_allowed": { "const": false },
+        "summary_only": { "const": true },
+        "redaction_required": { "const": true }
+      }
+    },
+    "summary": { "type": "string", "minLength": 1 },
+    "metrics": { "type": "object", "additionalProperties": { "type": ["number", "string", "boolean"] } }
+  }
+}

package/assets/payload/.agents/schemas/metrics/delivery-events.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://delano.local/schemas/metrics/delivery-events.schema.json",
+  "title": "Delano delivery metric event contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "event_id", "event_type", "timestamp", "project", "actor", "summary"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "event_id": { "type": "string", "pattern": "^evt-[0-9TZ._-]+-[a-z0-9-]+$" },
+    "event_type": {
+      "enum": [
+        "task_status_changed",
+        "validation_run",
+        "lease_acquired",
+        "lease_released",
+        "drift_report_generated",
+        "repair_plan_created",
+        "closeout_recorded"
+      ]
+    },
+    "timestamp": { "type": "string" },
+    "project": { "type": "string", "minLength": 1 },
+    "task_id": { "type": "string", "pattern": "^T-[0-9]{3}$" },
+    "actor": { "enum": ["agent", "system", "user"] },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "privacy"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1 },
+        "privacy": { "const": "metadata-only" },
+        "counts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } },
+        "status_from": { "type": "string" },
+        "status_to": { "type": "string" },
+        "result": { "enum": ["passed", "failed", "blocked", "warning", "generated"] }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "repo_paths": { "type": "array", "items": { "type": "string", "not": { "pattern": "^/" } } },
+        "commands": { "type": "array", "items": { "type": "string" } },
+        "commit": { "type": "string", "pattern": "^[0-9a-f]{7,40}$" }
+      }
+    }
+  }
+}

package/assets/payload/.agents/schemas/operating-modes.json

@@ -0,0 +1,42 @@
+{
+  "schema_version": 1,
+  "status": "draft",
+  "purpose": "Defines Delano operating modes used to size governance, evidence, and coordination overhead for delivery work.",
+  "modes": [
+    {
+      "mode": 0,
+      "slug": "patch",
+      "name": "Patch",
+      "use_when": "A small, well-understood correction with low uncertainty and no meaningful coordination surface.",
+      "requires": ["single task or direct patch", "focused validation evidence", "no new workstream unless needed"]
+    },
+    {
+      "mode": 1,
+      "slug": "scoped-change",
+      "name": "Scoped change",
+      "use_when": "A bounded change with clear acceptance criteria, known affected files, and no material discovery risk.",
+      "requires": ["task contract", "acceptance criteria evidence", "local validation"]
+    },
+    {
+      "mode": 2,
+      "slug": "feature",
+      "name": "Feature",
+      "use_when": "A feature-sized delivery with multiple implementation steps but a clear solution direction.",
+      "requires": ["spec and plan", "workstream or task sequence", "validation gate before done"]
+    },
+    {
+      "mode": 3,
+      "slug": "uncertain-feature",
+      "name": "Uncertain feature",
+      "use_when": "A feature where the solution, user value, or integration path is uncertain enough to require a probe first.",
+      "requires": ["uncertainty statement", "probe_required=true or explicit skip rationale", "probe evidence before build commitment"]
+    },
+    {
+      "mode": 4,
+      "slug": "multi-stream",
+      "name": "Multi-stream delivery",
+      "use_when": "Delivery spans concurrent streams, leases, external sync, or coordination boundaries where collision risk matters.",
+      "requires": ["workstream map", "conflict zones or leases", "handoff summaries", "sync/drift checks when external systems are involved"]
+    }
+  ]
+}

package/assets/payload/.agents/schemas/status-transitions.json

@@ -0,0 +1,31 @@
+{
+  "schema_version": 1,
+  "status": "draft",
+  "purpose": "Defines local validation rules for Delano task status readiness and blocked-state hygiene.",
+  "task_rules": [
+    {
+      "id": "ready-dependencies-done",
+      "status": "ready",
+      "description": "A ready task must not depend on a local task that is not done.",
+      "requires": ["all local depends_on task statuses are done"]
+    },
+    {
+      "id": "in-progress-dependencies-done",
+      "status": "in-progress",
+      "description": "An in-progress task must not start while local dependencies remain unresolved.",
+      "requires": ["all local depends_on task statuses are done"]
+    },
+    {
+      "id": "done-dependencies-done",
+      "status": "done",
+      "description": "A done task must not close over unresolved local dependencies.",
+      "requires": ["all local depends_on task statuses are done"]
+    },
+    {
+      "id": "blocked-owner-check-back",
+      "status": "blocked",
+      "description": "A blocked task must name who owns unblocking and when to check back.",
+      "requires": ["blocked_owner", "blocked_check_back"]
+    }
+  ]
+}