agent-feed-publish

name	agent-feed-publish
description	Use when previewing or publishing the local Agent Feed daily card to a Product draft Todo, investigating Agent Feed publish diagnostics, or recovering duplicate/reservation state. Defaults to dry-run safety and points agents to the repository guide before any live publish attempt.

Agent Feed publish workflow

Use this project-local skill when an operator or future agent asks to:

• generate and preview the latest Agent Feed daily card;
• run /agent-feed publish, agent_feed_publish, or npm run agent-feed:publish;
• configure Product draft Todo publishing;
• debug duplicate publicationKey, reservation, or Product adapter diagnostics;
• prove the publish workflow without live external product mutation.

Required reading

Read docs/agent-feed-publish.md before taking publish actions. It is the canonical operator guide for safe defaults, config boundaries, duplicate registry behavior, reservation recovery, diagnostic codes, redaction, and verification.

Safe workflow

1. Generate a local run:

   npm run agent-feed:run -- --no-network --max-items 3
   

2. Dry-run preview first:

   npm run agent-feed:publish --
   

   Equivalent pi surfaces are /agent-feed publish and agent_feed_publish with default parameters or mode: "dry-run".

3. Inspect status, mode, runId, latestPath, publicationKey, publicationStatePath, artifactPathsRead, warningCodes, errorCodes, transportAttempted, duplicateRecordSummary, transportResultSummary, and publicationRecord before reporting the result.

4. Only live publish after explicit operator intent and configuration:

   npm run agent-feed:publish -- --mode publish --publish
   

   Equivalent pi surfaces are /agent-feed publish --mode publish --publish and agent_feed_publish with mode: "publish" plus confirmPublish: true.

Configuration boundaries

• Credentials may come only from environment variables documented in docs/agent-feed-publish.md or from ~/.config/agent-feed/product-draft-todo.json.
• Never store or ask anyone to store credentials in repository files, .agent-feed/workspace/, run artifacts, docs, tests, or task summaries.
• Never echo credential values. Report only key names, non-secret paths, and diagnostic codes.
• The duplicate registry is .agent-feed/workspace/publications.json; it is local non-secret state used to block duplicate live publishes.

Verification commands

For no-live-mutation proof, run:

node scripts/verify-agent-feed-publish.mjs
node scripts/verify-agent-feed-extension.mjs
node --test tests/agent-feed-publisher.test.mjs tests/agent-feed-publish-cli.test.mjs tests/agent-feed-publish-state.test.mjs tests/agent-feed-extension-publish.test.mjs

Do not claim publish behavior is complete until fresh verification output has been produced after the last change.