promote

namespace	aiwg
name	promote
platforms	["all"]
description	Promote or graduate a project-local bundle to its upstream AIWG location or to a private corpus path.
triggers	["promote bundle","promote project-local","graduate project-local bundle","graduate to upstream","project-local bundle"]

Promote Project-Local Bundle

Graduate a proven project-local bundle without losing its source provenance.

Behavior

1. Identify the project-local bundle and its intended destination.

2. Preview the copy and registry transition:

   aiwg promote <name> --dry-run
   

3. Promote to the declared upstream location or a private corpus:

   aiwg promote <name> --to upstream
   aiwg promote <name> --to corpus <path>
   

4. Use --cleanup only when the project-local source should be removed after successful promotion. Use --force only after reviewing a destination conflict.

Safety

• Run aiwg doctor and a dry run before promotion.
• Promotion verifies the bundle manifest and destination before copying.
• Omit --cleanup to retain the project-local source.

References

• @$AIWG_ROOT/src/cli/handlers/subcommands.ts — promote command handler
• @$AIWG_ROOT/src/extensions/project-local-promote.ts — promotion implementation
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/steward-quickref/SKILL.md