All ten `archie-*` skills carried claims that no longer matched the
checkout. Re-verified each against code, git history, and the shipped
configuration, then corrected the drift.
Structural changes the skills had not caught up with:
- Composition root moved: `cmd/archied/main.go` is a ~30-line dispatcher
into `internal/app/archied.Run()` with wiring in `bootstrap.go`. The
skills still described `cmd/archied` as the wiring site, which also
silently zeroed the diagnostics delivery snapshot.
- Config decoding moved out of `internal/config` into
`internal/infrastructure/configuration`. `config.Load` / `config.LoadDir`
no longer exist; the loader is `configuration.New` + `Loader.Resolve`.
- Task contract moved to `internal/domain/storecontract`, with
`internal/store/interface.go` holding aliases only. The task type is
`internal/domain/workflow/task.Task`.
- `internal/workflow` became `internal/domain/workflow`; `internal/storerpc`
became gRPC `internal/infrastructure/staterpc`; `internal/policy` does not
exist.
- `Store.Transition` now guards on `from` and writes status plus history in
one transaction. Three skills still described the old non-atomic behavior
as current and open.
- `internal/domain/{messaging,workflow,workintake}`, `internal/eventbus`,
`internal/app`, and `internal/infrastructure` now exist.
`internal/domain/{agent,identity}` and `internal/policy` remain target-only.
Tooling and environment facts:
- Go 1.27.0 (root and tools modules), golangci-lint 2.13.2, staticcheck
2026.2.1; snapshot dates and HEAD moved to 2026-09-18 / 0ee2d27e.
- Re-ran the bundled diagnostics and re-baselined its snapshot table.
Confirmed 78.6% store coverage, a clean race run, and zero dupl findings.
- Corrected the claim that no `.dockerignore` exists; it does.
- Replaced skill script paths that pointed at the untracked `.claude/skills`
symlink with the canonical tracked `.agents/skills` location.
- Fixed the delivery-snapshot comment's wrong commit hash for the Gitea
workflow removal (dd9bddc2, not e539048).
Findings the verification closed:
- The VitePress site and `.github/workflows/docs.yml` were removed
(de150f20); the Gitea workflow was dropped (dd9bddc2).
- The changelog `vX.Y.Z`-vs-`X.Y.Z` contradiction is settled, not open: both
changelogs and the CI gate agree on `## [<version>]`.
- Tracked `docs/node_modules` and the skill-script test regression are
settled, not current.
- The six unmerged `origin/fix/*` and `origin/feat/*` candidate branches no
longer exist.
Also regenerates `docs/data/generated/contracts.json`, which the
verification found stale since a825db28: docsgen emits 11 schemas now, and
`MediaAttachment.raw` plus an `AgentExecutionResult.required` field were
missing. `cmp` passes after regeneration.
Verified with `task check` (green).
435 lines
12 KiB
JSON
435 lines
12 KiB
JSON
{
|
|
"generatedBy": "tools/docsgen",
|
|
"schemas": {
|
|
"AgentExecutionRequest": {
|
|
"additionalProperties": false,
|
|
"description": "Request is the complete, serializable input for one agent stage.",
|
|
"properties": {
|
|
"attempt": {
|
|
"type": "integer"
|
|
},
|
|
"budget": {
|
|
"$ref": "#/schemas/Budget"
|
|
},
|
|
"capture_tools": {
|
|
"items": {
|
|
"$ref": "#/schemas/CaptureTool"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"context_window": {
|
|
"type": "integer"
|
|
},
|
|
"extra_rules": {
|
|
"type": "string"
|
|
},
|
|
"gate": {
|
|
"$ref": "#/schemas/Gate"
|
|
},
|
|
"mission": {
|
|
"type": "string"
|
|
},
|
|
"model": {
|
|
"type": "string"
|
|
},
|
|
"notes": {
|
|
"type": "string"
|
|
},
|
|
"plugins": {
|
|
"description": "Plugins are bundled Yaegi plugins from the skill's plugins/\ndirectory. Each entry carries the name and source so the agent\ncan register them as tools. PRD section 5 Layer 1.",
|
|
"items": {
|
|
"$ref": "#/schemas/PluginSpec"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"preflight": {
|
|
"items": {
|
|
"$ref": "#/schemas/Command"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"protection": {
|
|
"$ref": "#/schemas/Protection"
|
|
},
|
|
"read_only": {
|
|
"type": "boolean"
|
|
},
|
|
"stage": {
|
|
"type": "string"
|
|
},
|
|
"task_id": {
|
|
"type": "integer"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
},
|
|
"workflow": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"version",
|
|
"task_id",
|
|
"attempt",
|
|
"stage",
|
|
"model",
|
|
"mission",
|
|
"budget",
|
|
"gate",
|
|
"protection"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"AgentExecutionResult": {
|
|
"additionalProperties": false,
|
|
"description": "Result is the serializable outcome of one agent stage.",
|
|
"properties": {
|
|
"appended_notes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"attempt": {
|
|
"type": "integer"
|
|
},
|
|
"captures": {
|
|
"additionalProperties": {
|
|
"items": true,
|
|
"type": "array"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"changes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"detail": {
|
|
"type": "string"
|
|
},
|
|
"iterations": {
|
|
"type": "integer"
|
|
},
|
|
"stage": {
|
|
"type": "string"
|
|
},
|
|
"status": {
|
|
"type": "string"
|
|
},
|
|
"stop_reason": {
|
|
"type": "string"
|
|
},
|
|
"summary": {
|
|
"type": "string"
|
|
},
|
|
"task_id": {
|
|
"type": "integer"
|
|
},
|
|
"tokens_used": {
|
|
"type": "integer"
|
|
},
|
|
"usage": {
|
|
"$ref": "#/schemas/Usage"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"version",
|
|
"task_id",
|
|
"attempt",
|
|
"stage",
|
|
"status",
|
|
"usage"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Budget": {
|
|
"additionalProperties": false,
|
|
"description": "Budget bounds one autonomous execution.",
|
|
"properties": {
|
|
"max_steps": {
|
|
"type": "integer"
|
|
},
|
|
"wall_clock": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"CaptureTool": {
|
|
"additionalProperties": false,
|
|
"description": "CaptureTool declares a structured-output tool whose calls are returned to the daemon as data.",
|
|
"properties": {
|
|
"boolean_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"max_calls": {
|
|
"type": "integer"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"non_empty_strings": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"parameters": true,
|
|
"required_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Command": {
|
|
"additionalProperties": false,
|
|
"description": "Command is one executable gate or preflight command.",
|
|
"properties": {
|
|
"argv": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"expect_failure": {
|
|
"type": "boolean"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"argv"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Gate": {
|
|
"additionalProperties": false,
|
|
"description": "Gate is the quality gate an agent must satisfy.",
|
|
"properties": {
|
|
"commands": {
|
|
"items": {
|
|
"$ref": "#/schemas/Command"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"max_consecutive_failures": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"MediaAttachment": {
|
|
"additionalProperties": false,
|
|
"description": "MediaAttachment describes a file attached to a message.",
|
|
"properties": {
|
|
"duration": {
|
|
"description": "Duration is the play time in seconds for audio and video.",
|
|
"type": "integer"
|
|
},
|
|
"file_id": {
|
|
"description": "FileID is the platform-assigned identifier for download APIs.",
|
|
"type": "string"
|
|
},
|
|
"file_name": {
|
|
"description": "FileName is the original file name when known.",
|
|
"type": "string"
|
|
},
|
|
"file_size": {
|
|
"description": "FileSize is the attachment size in bytes. nil means unknown.",
|
|
"type": "integer"
|
|
},
|
|
"height": {
|
|
"description": "Height is the pixel height for images and video. nil means unknown\nor not applicable.",
|
|
"type": "integer"
|
|
},
|
|
"mime_type": {
|
|
"description": "MIMEType is the content type (e.g. \"image/png\", \"audio/ogg\").",
|
|
"type": "string"
|
|
},
|
|
"path": {
|
|
"description": "Path is a local filesystem path on the host that produced the\nattachment. It is the alternative to URL for outbound delivery: a\nURL is fetched by the platform, a Path is uploaded by us. A file the\nagent wrote has no URL and never gets one -- publishing it would\ntrade a delivery problem for a hosting and access-control one -- so\nsenders that support upload must read this.\n\nExactly one of URL and Path is meaningful for an outbound send.",
|
|
"type": "string"
|
|
},
|
|
"raw": {
|
|
"description": "Raw carries platform-specific fields the common vocabulary does not\ncover, so adapters never need a second attachment type.",
|
|
"type": "object"
|
|
},
|
|
"type": {
|
|
"description": "Type is \"image\", \"video\", \"audio\", or \"document\".",
|
|
"type": "string"
|
|
},
|
|
"url": {
|
|
"description": "URL is a direct download URL when available. May be empty for\nplatforms that require a download API call.",
|
|
"type": "string"
|
|
},
|
|
"width": {
|
|
"description": "Width is the pixel width for images and video. nil means unknown\nor not applicable.",
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"file_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"MessageEvent": {
|
|
"additionalProperties": false,
|
|
"description": "MessageEvent is the rich message model for all gateway channels.",
|
|
"properties": {
|
|
"callback_data": {
|
|
"description": "CallbackData is the payload from a button or inline-keyboard\npress (Type == MsgCallback).",
|
|
"type": "string"
|
|
},
|
|
"channel_id": {
|
|
"description": "ChannelID identifies the conversation within the platform\n(chat ID, channel name, DM thread).",
|
|
"type": "string"
|
|
},
|
|
"edited_from": {
|
|
"description": "EditedFrom is the original text before the edit. Set only when\nType is MsgEdited.",
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"description": "ID is the platform-assigned message identifier. Used for reply\nthreading, reactions, and edit/delete tracking.",
|
|
"type": "string"
|
|
},
|
|
"media": {
|
|
"description": "Media holds attached files. Nil for text-only messages.",
|
|
"items": {
|
|
"$ref": "#/schemas/MediaAttachment"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"platform": {
|
|
"description": "Platform names the source adapter (\"telegram\", \"discord\",\n\"web\", \"slack\").",
|
|
"type": "string"
|
|
},
|
|
"raw": {
|
|
"description": "Raw is the original platform-specific payload. Adapters set\nthis for debug logging or handlers that need platform details\nnot captured by the generic fields.",
|
|
"type": "object"
|
|
},
|
|
"reacted_to_id": {
|
|
"description": "ReactedToID is the message being reacted to.",
|
|
"type": "string"
|
|
},
|
|
"reaction": {
|
|
"description": "Reaction is the emoji used when Type is MsgReaction.",
|
|
"type": "string"
|
|
},
|
|
"reply_to_id": {
|
|
"description": "ReplyToID is the platform message ID this message is in reply\nto. Empty for top-level messages.",
|
|
"type": "string"
|
|
},
|
|
"sender_id": {
|
|
"description": "SenderID is the platform-specific sender identifier.",
|
|
"type": "string"
|
|
},
|
|
"sender_name": {
|
|
"description": "SenderName is the display name when available.",
|
|
"type": "string"
|
|
},
|
|
"text": {
|
|
"description": "Text is the human-readable message body. It carries the caption\nfor media messages and the full content for text and system\nmessages.",
|
|
"type": "string"
|
|
},
|
|
"thread_id": {
|
|
"description": "ThreadID identifies the conversation thread for platforms that\nsupport threading (Slack, Discord forums).",
|
|
"type": "string"
|
|
},
|
|
"timestamp": {
|
|
"description": "Timestamp is the platform-assigned message time in Unix\nmilliseconds. Zero when unknown.",
|
|
"type": "integer"
|
|
},
|
|
"type": {
|
|
"description": "Type discriminates the message kind.",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"channel_id",
|
|
"platform",
|
|
"sender_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"PluginSpec": {
|
|
"additionalProperties": false,
|
|
"description": "PluginSpec is a bundled Yaegi plugin passed from daemon to agent.",
|
|
"properties": {
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"src": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"src"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Protection": {
|
|
"additionalProperties": false,
|
|
"description": "Protection describes paths the agent may read but not mutate.",
|
|
"properties": {
|
|
"globs": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"suffixes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"Usage": {
|
|
"additionalProperties": false,
|
|
"description": "Usage preserves provider-reported token economics for evaluation.",
|
|
"properties": {
|
|
"cache_creation_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"cached_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"completion_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"prompt_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"total_tokens": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
}
|
|
}
|
|
}
|