feat: ACP SDK v2 → v3 migration Qchainer prep agent trader showcase

[drQedwards]

Showcase Project

What shipped

• Project slug: acp-sdk-v2-to-v3-migration
• Project title: ACP SDK v2 → v3 Migration
• Builder name and URL: Dr. Q (@jk_drq) / Qchain — https://x.com/jk_drq
• EconomyOS primitives used: wallet, acp
• Public proof:
  • Offline self-check + redacted dry-run report (no keys, no mainnet txs)
  • X video/watch surface: @jk_drq Distorted Face Piano Space — https://x.com/i/spaces/1dKrPPWnNDzJX
• Optional soul.md: showcase/acp-sdk-v2-to-v3-migration/soul.md (public/redacted)

Project package

• Added or updated showcase/acp-sdk-v2-to-v3-migration/showcase.json
• Added demo artifacts, prompt, proof, and redacted report
• Added reusable skill under showcase/acp-sdk-v2-to-v3-migration/skills/acp-sdk-v2-to-v3-migration/
• Used top-level skills/<skill-name>/ only when the skill is shared across projects (this skill is project-specific)
• Set skills[].sourcePath in showcase.json
• Linked all public artifacts from the manifest
• Included exactly three feedback prompts
• hidden: true not set — publish card after merge
• Linked soul.md as public/redacted agent context

Skill standard

• Skill path: showcase/acp-sdk-v2-to-v3-migration/skills/acp-sdk-v2-to-v3-migration
• SKILL.md includes when to use it and when not to use it
• Inputs, tools, credentials, and preconditions are explicit
• Approval gates are listed for spending / live mode / dashboard upgrade
• Stop conditions and handoff rules are listed
• Validation checks and output contract are included

Safety and redaction

• No card numbers, CVVs, OTPs, magic links, API keys, access tokens, private prompts, wallet material, or private account records are published
• Live workflow evidence is redacted (offline dry-run only)
• Public/private boundaries are explained
• Optional soul.md does not include private instructions, credentials, account data, wallet material, or operational secrets
• X Space is public watch-page only — no scraped/re-hosted audio binary

Video / X proof

• Builder X: https://x.com/jk_drq
• Primary piano Space: https://x.com/i/spaces/1dKrPPWnNDzJX (Distorted Face Piano)
• Manifest wiring:
  • links.video / links.share → Space URL
  • visual.videoLabel → names X
  • visual.videoUrl omitted (Spaces have no stable public video.twimg.com mp4)
  • visual.posterUrl → package poster PNG
• Notes: showcase/acp-sdk-v2-to-v3-migration/proof/jk-drq-piano-spaces.md

Validation ran

node showcase/acp-sdk-v2-to-v3-migration/scripts/self-check.mjs   # 10/10 pass
node showcase/acp-sdk-v2-to-v3-migration/examples/v3-provider.mjs
node showcase/acp-sdk-v2-to-v3-migration/examples/v3-client.mjs
node scripts/validate-showcase.mjs                               # manifests OK

Publish path

After this PR is approved and merged to main, changes under showcase/** trigger the EconomyOS docs sync. The accepted manifest is published into /community#showcase by the docs workflow.

[drQedwards]

Public X video proof wired

Builder: @jk_drq

Primary piano Space used as links.video / links.share:

• Distorted Face Piano — https://x.com/i/spaces/1dKrPPWnNDzJX

Manifest notes:

• visual.videoLabel names X
• visual.videoUrl omitted (Spaces page, no stable public amplify mp4)
• local poster kept for the card
• proof write-up: showcase/acp-sdk-v2-to-v3-migration/proof/jk-drq-piano-spaces.md

If you have additional piano Space URLs/status clips on @jk_drq that should be listed alongside this one, drop them in-thread and I’ll append artifacts.

[drQedwards]

Telegram demo surface

Public desk bot wired into the showcase:

• https://t.me/Qchaingoldbot (@Qchaingoldbot)
• Manifest: links.demo + artifact
• Notes: showcase/acp-sdk-v2-to-v3-migration/proof/telegram-qchaingoldbot.md

X piano Space remains links.video / links.share.

[drQedwards]

Pipeline is green on the fork — needs workflow approval upstream

Pushed 1998f69, which adds a package-scoped CI workflow and declares the builder association.

What's in the commit

• .github/workflows/showcase-acp-sdk-v2-to-v3-migration.yml — gated on showcase/acp-sdk-v2-to-v3-migration/**
• showcase.json — builder.association: "champion", asserted in CI

Steps the workflow runs

1. node scripts/validate-showcase.mjs — manifest validation
2. node --check on v3-provider.mjs, v3-client.mjs, phase-event-map.mjs, v2-provider.legacy.mjs
3. npm run check — 10 offline self-check assertions
4. Skill installability into ~/.agents/skills and ~/.claude/skills
5. Proof artifact presence — piano Spaces notes, offline validation receipt, Telegram notes, poster, soul.md

Result on the fork — run 30723206354, job package self-check, success, all 10 steps passing:

github author_association : N/A
declared association      : champion
builder.association = champion
Validated 55 showcase project manifest(s).
10 checks passed

On association — GitHub's author_association is derived from repository permissions and cannot be set by a contributor. champion is a manifest-level declaration only. The workflow prints GitHub's derived value alongside the declared one in the job summary so the distinction is visible in review rather than implied.

The ask

Both typecheck and the new workflow have been sitting at action_required on this repo since 18:47 UTC — every run is 0s, nothing has executed upstream. Fork PRs from unaffiliated accounts need a maintainer to approve workflow runs.

Could someone approve the runs on this PR? That's the only thing between this and a reviewable green PR — the code side is done and passing. Happy to re-push if you'd prefer the workflow scoped differently or dropped entirely in favour of the existing typecheck job.

[github-actions]

This URL needs to point to the main repo to work after the PR is merged. Could you update the owner and branch?

Suggested change

	"posterUrl": "https://raw.githubusercontent.com/drQedwards/acp-cli-demos/feat/acp-sdk-v2-to-v3-migration/showcase/acp-sdk-v2-to-v3-migration/assets/poster.png",
	"posterUrl": "https://raw.githubusercontent.com/Virtual-Protocol/acp-cli-demos/main/showcase/acp-sdk-v2-to-v3-migration/assets/poster.png",

[github-actions]

This is a really impressive and thorough migration kit, thanks for putting it together! The side-by-side code examples and the offline self-checks are great for developers.

A quick heads-up: this is a bit different from our usual showcase entries, which typically feature agents performing live economic actions. Since this is more of a developer resource, we'll need a maintainer to make the final call on where it fits best in the community section.

I found a couple of things to align with the showcase format before this can be merged:

1. Showcase packages are data-only, so the custom GitHub Actions workflow, package.json, and .gitignore in the package directory should be removed. The main repo's CI handles all the validation needed.
2. The topics list in the manifest includes some tags that aren't in our standard set (sdk, migration, etc.). To keep things consistent, could we trim this down to just skills and acp?
3. The link to the X Space (the piano video) is a bit confusing as "proof". The real proof seems to be the offline validation reports. It might be better to reframe the video as builder context rather than proof of the migration kit itself.

I've also left one small suggestion inline to update the posterUrl so it works after merging. Let me know what you think!