layerkit-author-map

layerkit-author-map

Author a vendor_map proposal only from cited evidence (research notes, OpenAPI, curl, customer docs).

Protocol

1. Prerequisites: layerkit-research-vendor answer sheet + layerkit-design-integration shape = linear or hybrid.

2. Read OpenAPI/docs/curl evidence directly. Do not derive a map from operation names or schema property names alone; map only when vendor meaning and customer domain meaning are both evidenced.

3. Explicit scaffold when you already know the mapping from evidence:

layerkit proposal write map \
  --vendor <vendor> \
  --out ./map-proposal.json \
  --source "Events API=https://docs.example.com/api/events|event_name is required" \
  --endpoint POST:/v1/events@https://api.example.com \
  --intent purchase:Purchase \
  --field user.email:user_data.em \
  --agent <agentId> \
  --validate

• --source title=url is required (repeatable). Optional |excerpt after the URL.
• Does not auto-submit. Next tip: layerkit proposal validate <file>.

1. Or draft proposal JSON by hand:

{
  "schemaVersion": 2,
  "kind": "vendor_map",
  "id": "map-<vendor>-v1",
  "vendor": "<vendor>",
  "summary": "<what changed>",
  "authoredBy": "agent",
  "status": "draft",
  "createdAt": "<ISO>",
  "sources": [
    { "title": "...", "url": "https://...", "excerpt": "..." }
  ],
  "payload": {
    "vendor": "<vendor>",
    "version": "1",
    "status": "map_complete",
    "documentation": [{ "title": "...", "url": "https://..." }],
    "auth": { "type": "bearer", "notes": "..." },
    "endpoint": { "method": "POST", "path": "/...", "baseUrl": "https://..." },
    "intents": { "purchase": { "eventName": "..." } },
    "fields": [
      {
        "domain": "user.email",
        "vendor": "user_data.em",
        "transform": { "type": "processor", "processorId": "..." },
        "optional": true
      }
    ]
  },
  "maker": { "type": "agent", "id": "<agent>" },
  "changeLog": "Initial map from docs"
}

1. Every auth type, endpoint, eventName, and field row must map to a sources[] excerpt (or nested processor sources).
2. Missing evidence → omit the row and mark needs-evidence in summary/memory — do not invent.
3. Validate + memory: