docs(complete): align publish CLI flags with implementation (closes #767)

[voidborne-d]

Summary

complete.md documents three flags for mcp-publisher publish that the CLI does not actually parse:

• --file=PATH — Path to server.json
• --registry=URL — Registry URL override
• --dry-run — Validate without publishing

Reading cmd/publisher/commands/publish.go and cmd/publisher/main.go confirms the actual interface is a single positional PATH argument (default ./server.json):

serverFile := \"server.json\"
if len(args) > 0 && !strings.HasPrefix(args[0], \"-\") {
    serverFile = args[0]
}

Registry URL is bound at login time via the saved token, and "validate without publishing" is a separate mcp-publisher validate subcommand. The bug user in #767 hit "server.json not found" precisely because --file .registry/server.json is filtered out by the HasPrefix(args[0], \"-\") check, leaving the default lookup in place.

Background

The canonical reference at docs/reference/cli/commands.md was already updated to the correct positional shape. complete.md (the concatenated single-file mirror of docs/ used for LLM/quickstart consumption) had drifted out of sync — these were the only remaining --file references in the repo outside of test fixtures.

Per the discussion on the prior flag-implementation attempt in #771, maintainers preferred fixing the documentation over adding the unimplemented flags:

@domdomegg: I'd lean towards removing the options from the docs.

This PR closes that loop on the last stale doc surface.

Changes

complete.md: the mcp-publisher publish block now matches docs/reference/cli/commands.md line-for-line (positional PATH, no spurious flags, no dry-run example).

-mcp-publisher publish [options]
+mcp-publisher publish [PATH]

-- \`--file=PATH\` - Path to server.json (default: \`./server.json\`)
-- \`--registry=URL\` - Registry URL override
-- \`--dry-run\` - Validate without publishing
+- \`PATH\` - Path to server.json (default: \`./server.json\`)

-# Dry run validation
-mcp-publisher publish --dry-run
-
 # Custom file location
-mcp-publisher publish --file=./config/server.json
+mcp-publisher publish ./config/server.json

Closes #767.

Out of scope

• cmd/publisher/README.md:17 still shows ./bin/mcp-publisher publish --registry=http://localhost:8080 in the contributor quickstart. The flag is silently ignored at runtime (caught by the same HasPrefix(\"-\") filter). Happy to fold that fix into this PR or send a follow-up — flagging here in case a maintainer prefers one option.
• complete.md is missing mcp-publisher validate and mcp-publisher status sections that exist in docs/reference/cli/commands.md. Out of scope for this single-concern PR; if there's interest, a broader sync would be a separate PR.

Test plan

• grep -r -- '--file' . outside test fixtures returns 0 hits after the change
• grep -r 'mcp-publisher publish --' docs/ complete.md shows only legitimate flags (--registry on login)
• No code changes — make check not exercised since this is doc-only

🤖 Generated with Claude Code

[voidborne-d]

Thanks for the quick review and merge, @rdimitrov!