larksuite/cli · error

PostMount added undeclared Typed flag --%s

Error message

PostMount added undeclared Typed flag --%s

What it means

PostMount integrity guard: a PostMount hook registered a flag (--name) that was not part of the compiled Typed flag set captured before mounting.

Source

Thrown at shortcuts/common/typed_mount_guard.go:95

	}
	names := make([]string, 0, len(before.flags)+len(after.flags))
	seen := make(map[string]struct{}, len(before.flags)+len(after.flags))
	for name := range before.flags {
		seen[name] = struct{}{}
		names = append(names, name)
	}
	for name := range after.flags {
		if _, ok := seen[name]; !ok {
			names = append(names, name)
		}
	}
	sort.Strings(names)
	for _, name := range names {
		beforeFlag, existedBefore := before.flags[name]
		afterFlag, existsAfter := after.flags[name]
		switch {
		case !existedBefore:
			return fmt.Errorf("PostMount added undeclared Typed flag --%s", name)
		case !existsAfter:
			return fmt.Errorf("PostMount removed Typed flag --%s", name)
		case !reflect.DeepEqual(beforeFlag, afterFlag):
			return fmt.Errorf("PostMount modified Typed flag --%s or its input annotations", name)
		}
	}
	return nil
}

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Declare the flag in the compiled definition instead of adding it in PostMount

When it happens

Trigger: Thrown at shortcuts/common/typed_mount_guard.go:95 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of larksuite/cli@7fd6ef3c07 (2026-09-04). Data as JSON: /api/errors/25374a13ac7d029e. Report an issue: GitHub.