Skip to content

Publish core.select-items-for-followup 1.2.0 #246

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
enricopiovesan merged 1 commit into from
Aug 10, 2026
Merged

Publish core.select-items-for-followup 1.2.0 #246

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
342 changes: 342 additions & 0 deletions capabilities/core/core.select-items-for-followup/1.2.0/contract.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,342 @@
{
"kind": "capability_contract",
"schema_version": "1.0.0",
"id": "core.select-items-for-followup",
"namespace": "core",
"name": "select-items-for-followup",
"version": "1.2.0",
"lifecycle": "active",
"owner": {
"team": "loop",
"contact": "founders@loop.dev"
},
"summary": "Decides which open action items need attention now. Council-revised with quiet hours, snooze support, per-user nudge budgets and higher escalation bar.",
"description": "Hero capability of Loop (council-revised). Key improvements from 1.0.0:\n- Respects per-user quiet hours and snooze until timestamps\n- Enforces max nudges per user per day\n- Escalation only after repeated ignored nudges + high pressure\n- Explicit skip reasons (quiet_hours, snoozed, budget_exceeded, recently_active, low_pressure)\n- Still pure and deterministic \u2014 no messages are sent, only the selection decision is produced.\n\nImplemented and smoke-tested matrix (use_cases):\n- quiet-hours skip\n- escalate selection for overdue high-pressure items\n- config_error when reference_datetime is empty\n\nKnown limitations (intentional in 1.2.0):\n- No message delivery; selection decision only",
"use_cases": [
{
"scenario": "As a scheduled job, I want to respect quiet hours and snooze so that we never annoy people at the wrong time.",
"input_example": {
"open_items": [
{
"id": "ai-1",
"owner_id": "user-ada",
"due_date": "2026-08-08",
"status": "open",
"last_activity_at": "2026-08-05T10:00:00Z",
"nudge_count": 0,
"pressure_score": 0.85,
"snoozed_until": null
}
],
"user_preferences": {
"user-ada": {
"quiet_hours": {
"start": "20:00",
"end": "08:00",
"timezone": "America/Los_Angeles"
},
"max_nudges_per_day": 2,
"nudges_sent_today": 0
}
},
"reference_datetime": "2026-08-07T22:30:00Z",
"followup_config": {
"version": "1.1",
"soft_days_before_due": 2,
"direct_days_overdue": 1,
"escalate_after_nudges": 3,
"min_pressure_for_soft": 0.4,
"respect_quiet_hours": true
}
},
"output_example": {
"selected": [],
"skipped": [
{
"item_id": "ai-1",
"reason": "quiet_hours",
"detail": "owner is inside quiet hours 20:00-08:00"
}
],
"reason_code": "ok",
"evaluation_trace": [
"1 item evaluated",
"skipped due to quiet_hours"
]
},
"happy": true,
"persona_ref": "runtime-engineer"
},
{
"scenario": "As a system, I want escalation only after clear neglect signals, so that owners are not escalated on the first soft reminder.",
"input_example": {
"open_items": [
{
"id": "ai-9",
"owner_id": "user-bob",
"due_date": "2026-08-01",
"status": "open",
"last_activity_at": "2026-07-28T09:00:00Z",
"nudge_count": 3,
"pressure_score": 0.95,
"snoozed_until": null
}
],
"user_preferences": {
"user-bob": {
"quiet_hours": null,
"max_nudges_per_day": 3,
"nudges_sent_today": 0
}
},
"reference_datetime": "2026-08-07T10:00:00Z",
"followup_config": {
"version": "1.1",
"soft_days_before_due": 2,
"direct_days_overdue": 1,
"escalate_after_nudges": 3,
"min_pressure_for_soft": 0.4,
"respect_quiet_hours": true
}
},
"output_example": {
"selected": [
{
"item_id": "ai-9",
"intensity": "escalate",
"reason": "3 prior nudges ignored + overdue + high pressure",
"recommended_channel": "manager"
}
],
"skipped": [],
"reason_code": "ok",
"evaluation_trace": [
"escalation threshold met"
]
},
"happy": true,
"persona_ref": "runtime-engineer"
},
{
"scenario": "As a scheduled job, I want config_error when reference_datetime is empty, so that the run fails closed instead of selecting blindly.",
"input_example": {
"open_items": [],
"user_preferences": {},
"reference_datetime": "",
"followup_config": {
"version": "1.1",
"soft_days_before_due": 2,
"direct_days_overdue": 1,
"escalate_after_nudges": 3,
"min_pressure_for_soft": 0.4,
"respect_quiet_hours": true
}
},
"output_example": {
"selected": [],
"skipped": [],
"reason_code": "config_error",
"evaluation_trace": [
"required fields missing"
]
},
"happy": false,
"persona_ref": "runtime-engineer"
}
],
"inputs": {
"schema": {
"type": "object",
"required": [
"open_items",
"reference_datetime",
"followup_config"
],
"properties": {
"open_items": {
"type": "array",
"items": {
"type": "object"
}
},
"user_preferences": {
"type": "object",
"additionalProperties": true
},
"reference_datetime": {
"type": "string"
},
"followup_config": {
"type": "object",
"required": [
"version"
],
"properties": {
"version": {
"type": "string"
},
"soft_days_before_due": {
"type": "integer"
},
"direct_days_overdue": {
"type": "integer"
},
"escalate_after_nudges": {
"type": "integer"
},
"min_pressure_for_soft": {
"type": "number"
},
"respect_quiet_hours": {
"type": "boolean"
}
}
}
}
}
},
"outputs": {
"schema": {
"type": "object",
"required": [
"selected",
"skipped",
"reason_code"
],
"properties": {
"selected": {
"type": "array",
"items": {
"type": "object",
"required": [
"item_id",
"intensity",
"reason"
],
"properties": {
"item_id": {
"type": "string"
},
"intensity": {
"type": "string",
"enum": [
"soft",
"direct",
"escalate"
]
},
"reason": {
"type": "string"
},
"recommended_channel": {
"type": "string"
}
}
}
},
"skipped": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string"
},
"reason": {
"type": "string"
},
"detail": {
"type": "string"
}
}
}
},
"reason_code": {
"type": "string",
"enum": [
"ok",
"config_error"
]
},
"evaluation_trace": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"preconditions": [],
"postconditions": [
{
"id": "deterministic",
"description": "Identical inputs produce identical outputs"
}
],
"side_effects": [
{
"kind": "memory_only",
"description": "Pure selection decision"
}
],
"emits": [],
"consumes": [],
"permissions": [
{
"id": "core.select-items-for-followup"
}
],
"execution": {
"binary_format": "wasm",
"entrypoint": {
"kind": "wasi-command",
"command": "run"
},
"preferred_targets": [
"local",
"edge",
"browser"
],
"constraints": {
"host_api_access": "none",
"network_access": "forbidden",
"filesystem_access": "none"
}
},
"policies": [
{
"id": "anti-spam-by-design"
}
],
"dependencies": [],
"provenance": {
"source": "ai-assisted",
"author": "loop-founders + traverse-capability-author",
"created_at": "2026-08-08T06:20:00Z",
"spec_ref": "core.select-items-for-followup@1.2.0",
"adr_refs": [
"persona-council-review-2026-08-08"
],
"exception_refs": []
},
"evidence": [
{
"evidence_id": "core-select-items-for-followup-1.2.0-contract-validation",
"type": "contract_validation",
"status": "passed"
}
],
"service_type": "stateless",
"permitted_targets": [
"local",
"edge",
"browser",
"cloud"
],
"artifact_type": "native",
"artifact": {
"digest": "sha256:776940c947298b22db406e36fca944d2f6596822a5bd365265a541a1cce4b56e",
"url": "https://github.com/traverse-framework/registry/releases/download/artifacts/core.select-items-for-followup-1.2.0/core-select-items-for-followup.wasm"
}
}
Loading