noodle distributions

Publish immutable host packages and operate their delivery lifecycle.

Usage

noodle distributions publish|list|inspect|download|readiness|review|release|rollback|deprecate|revoke|grant

Subcommands

• publish <deployment-id> [<server.ts>] — Build locally, bind to the exact deployment snapshot, and publish one package.
  • --target openai|claude — Host package target. (required)
  • --category <category> — OpenAI submission category; required only for the OpenAI target.
  • --connectors <file> — Connector catalog override used to compile the exact local source.
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• list <deployment-id> — List immutable distribution versions for one deployment.
  • --target openai|claude — Optionally filter by host package target.
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• inspect <distribution-id> — Inspect immutable metadata and current lifecycle state without archive bytes.
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• download <distribution-id> — Download exact archive bytes and verify their immutable digest before writing.
  • --output <archive.zip> — Destination for the verified archive bytes. (required)
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• readiness <distribution-id> — Record whether one immutable version is draft, ready, or blocked.
  • --status draft|ready|blocked — Operator-confirmed delivery readiness. (required)
  • --note <text> — Optional readiness note. (1-1000 characters)
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• review <distribution-id> — Record a human-reported external host review status and optional feedback.
  • --status submitted|in-review|changes-requested|approved|rejected|published|withdrawn — Human-reported host review status; Noodle does not infer host actions. (required)
  • --feedback <text> — Human-entered host feedback; required for changes-requested or rejected. (1-4000 characters)
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• release <distribution-id> — Move the stable release channel forward to this ready version.
  • --visibility private|public — Private grant-only delivery or public discovery and delivery. (required)
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• rollback <distribution-id> — Move the stable release pointer to this older ready version.
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• deprecate <distribution-id> — Stop delivery of this version while retaining its immutable record.
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• revoke <distribution-id> — Permanently revoke delivery of this version.
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.
• grant <distribution-id> — Create a short-lived exact-version private archive download URL.
  • --expires-in <seconds> — Grant lifetime in seconds. (default 900; range 60-3600)
  • --org <slug> — Organization slug.
  • --service <url> — Control-plane service URL.
  • --auth-token <token> — Control-plane authentication token.
  • --json — Emit JSON output.

Run noodle distributions --help for the latest options and details.